QuickTime 1.6 FeaturesQuickTime QuickTime 1.6 April, 1993This note is a technical discussion of the changes between QuickTime 1.5 and QuickTime 1.6. QuickTime 1.6 introduces some new features, and is more reliable than other QuickTime versions. The note also discusses the new features of QuickTime 1.6's Component Manager.TopicsÑ QuickTime 1.6 Features: Describes how to access the new features.Ñ Component Manager 3.0 Features: Describes how to access the new features.Ñ QuickTime 1.6 Bug Fixes: Describes the bug fixes.QuickTime 1.6 FeaturesThe new features of QuickTime 1.6 are fully described in this note. These new features can be logically divided into two sections: "Features You Get For Free" and "Features You Get With Some Code." This documentation assumes the reader is QuickTime-literate. If this documentation does not suffice, refer to Inside Macintosh: QuickTime and Inside Macintosh: QuickTime Components which are currently available from APDA. In addition, most QuickTime questions are answered through rummaging through the sample code and/or applications on the QuickTime 1.5 CD. Also, the QuickTime 1.0 CD serves as an excellent reference.Features You Get For FreeThis section describes the features of QuickTime 1.6 which are added transparently to QuickTime. In general, your application will not have to do anything to your application for these features. But the user may have to install a specific extension and/or have the appropriate equipment. QuickTime 1.6 exploits these extensions: Sound Manager, Macintosh Easy Open, and ColorSync. In addition, it exploits the CD ROM 300(i), grayscale PowerBooks, Macintosh LC II class machines, Quadras, and stereo output devices. The exact nature of the exploitation is discussed in the various sections below.Reduced Memory FootprintQuickTime 1.6 code has been segmented. QuickTime's code segmentation allows unused code segments to be unloaded when not in use. QuickTime 1.6 uses less than 18k when installed whereas QuickTime 1.5 used approximately 160k.Because of this segmentation, substantially less memory is required for movie playback. If applications are not using a particular functionality, the corresponding code segments may be unloaded. For example, movie editing code will not be loaded unless the movie application requires it. Sound Manager 3.0 SupportQuickTime 1.6 is released with the new Sound Manager, Version 3.0. Since the new Sound Manager completely replaces the existing Sound Manager, it will work with all versions of QuickTime and all existing applications. If the Sound Manager 3.0 is installed, QuickTime 1.6 will take advantage of it's new features.You can use QuickTime with the Sound Manager 3.0 in the following ways:Ñ Spit multiple sound tracks into one sound resourceThe best feature of the new Sound Manager is the ability to mix multiple sound tracks into one sound resource.Ñ╩Play sound more efficientlyThe new Sound Manager lessens the load on the CPU for sound. As a rule of thumb, you will be able to get one extra frame per second for video playback.Ñ╩Support alternate sound output devicesThis allows you to hook up hardware to your Macintosh for CD quality 16-bit 44 kHz stereo sound output.Ñ╩Allow better control over multiple sound channelsWith Sound Manager 3.0, sound overdriving is now possible. By setting the movie volume above 1.0, the sound will actually be overdriven. Ñ Support true balance controlÑ Handle sound mixing better, which improves the quality of multiple sound track playbackÑ Use the new Sound Control PanelCompact Video EnhancementCompact Video playback to 16 bit destinations (thousands of colors) is now higher quality. The dithering algorithm has been significantly improved.Audio CD ImportA Movie Import component has been provided which allows you to open Audio CD tracks from QuickTime╒s Standard File Preview dialog, just as you could open PICS and AIFF files with QuickTime 1.5. If you have a Apple CD 300 or CD 300i drive, you can use QuickTime 1.6 to convert tracks of your favorite audio CD directly into QuickTime movies. Figure 1. When you try to open an audio track on a CD 300(i), the Open button will change to a Convert╔ button. When you click this button, the Audio CD Import Options dialog will pop up. With this dialog, you can configure the sound settings of the movie. The rate, size, and channel can be specified for the movie. In addition, you can select the portion of the track which should become a movie. You can select the start time and end time for the track. You can play your selection to be sure you have the selection you want.Text Track ExportA Text Movie Export component lets you easily extract text from movies. With Macintosh Easy Open installed, you can copy a series of text frames from a movie, and paste them directly into any application that supports text, such as MPW.Macintosh Easy Open SupportQuickTime 1.6 fully supports Macintosh Easy Open. Macintosh Easy Open is an Apple system extension which provides document and clipboard translation for all applications. If a user has Macintosh Easy Open installed in combination with QuickTime 1.6, then they can copy and paste various media formats without thought.QuickTime 1.5 contained translation components for importing and exporting movie data from files and the clipboard. QuickTime 1.6 provides a Macintosh Easy Open translation component which makes all QuickTime movie import/export components work automatically with non-QuickTime-aware applications. For example, you can paste a sound track into a Sound Editing application, and it will translate the format from a QuickTime sound movie to a sound file.QuickTime 1.6 includes support for importing sound, PICTs, and PICS. It also supports exporting movies to PICT and sound. Additional MovieImport and MovieExport components can be found on the QuickTime 1.5 Developer CD in the Sample Components folder.Tear-free Movie PlaybackSupport has been added to the Image Compression Manager to reduce the tearing that is visible when playing back movies with large amounts of motion. The feature only works on machines with fast screen access, so it isn╒t usually enabled for NuBus video cards. Typically, better tear-free movie playback will be seen on Compact Video movies in 16-bit on a Quadra. A good movie to look to see the improvement is the beginning of ╥Everybody Loves Me But You╙ on the QuickTime 1.5 Developer CD.PowerBook Movie Playback EnhancementsThe PowerBooks which use 4-bit gray scale (PowerBook 160, 180, Duo 210, Duo 230) are supported using new fast dithering. All decompressors transparently take advantage of this fast dithering.YUV CodecA YUV Compressor/Decompressor Component has been added to QuickTime 1.6. It stores data in YUV 4:2:2 format. The compression algorithm is not lossless, but the image quality is extremely high. The compression ratio is 2:1. It does not support frame differencing. It is useful with certain video input solutions. In addition, it is also useful as an intermediate storage format if you are applying multiple effects or transitions to an image.By default, YUV does not appear in the Standard Compression dialog. If you hold down the option key when clicking on the compressor list to display the complete list, it will appear.Features You Get With Some CodeThis section describes the features of QuickTime 1.6 which are NOT added transparently to QuickTime. Your application will need new code to take advantage of them. In this section, the use of these features are explained.Movie Toolbox EnhancementsThe Movie Toolbox has three new calls, and two new flags. First, we will talk about the new flag. When using either PasteHandleIntoMovie or ConvertFileToMovieFile to import data into a movie, you can now set the showUserSettingsDialog flag. This will cause the user settings dialog for that import operation to be displayed, if there is one. For example, when importing a picture, this would cause the Standard Compression dialog to be displayed so the compression method could be selected. showUserSettingsDialog = 2hintsHighQuality is a new flag to the SetMoviePlayHints and SetMediaPlayHints routines. It specifies that the given movie or media should render at the highest quality. Rendering at highest quality may take considerably more time and memory. Therefore, this mode is typically not appropriate for real time playback, but is very useful for recompressing as it can generate higher quality images. hintsHighQuality = 1<<8 The high quality mode can be used with other media handlers as well. For example, the Video Media Handler turns off fast dithering and allows high quality dithering. Now we will introduce the three new Movie Toolbox calls.SetMovieDrawingCompleteProcSetMovieDrawingCompleteProc lets you set a call back procedure that is called after a Movie has drawn in one or more of its tracks. In this way, your application can be aware of when QuickTime has drawn frames, and when it hasn╒t. This information is very useful when combined with SetTrackGWorld (see below).pascal void SetMovieDrawingCompleteProc(Movie theMovie, MovieDrawingCompleteProcPtr proc, long refCon)theMovie The Movie to set the proc on.proc Your call back procedure, or nil to remove it.refCon Value to pass to your call back procedure.typedef pascal OSErr (*MovieDrawingCompleteProcPtr)(Movie theMovie, long refCon);Errors invalidMovie -2010 Your movie reference is bad.SetTrackGWorldSetTrackGWorld lets you force a track to draw into a particular GWorld. This GWorld may be different from that of the entire movie. After the track has drawn, it calls your transfer procedure to copy the track to the actual movie GWorld. When your transfer procedure is set, the current GWorld is set to the correct destination. You can also install a transfer procedure and set the GWorld to nil. This will result in your transfer procedure being called only as a notification that the track has drawn -- no transfer needs to take place.pascal void SetTrackGWorld(Track theTrack, CGrafPtr port, GDHandle gdh, TrackTransferProc proc, long refCon)theTrack The track to set the proc to.port The port for the track to draw to, or nil to use the Movie╒s GWorld.gdh GDevice associated with the port.proc Returns pointer to your transfer procedure, or nil to remove it.refCon Value to pass to your tranfer procedure.typedef pascal OSErr (*TrackTransferProc)(Track t, long refCon);Errors invalidMovie -2009 Your track reference is bad.GetMovieCoverProcsGetMovieCoverProcs lets you retrieve the cover procs that you set with SetMovieCoverProcs.pascal OSErr GetMovieCoverProcs(Movie theMovie, MovieRgnCoverProc *uncoverProc, MovieRgnCoverProc *coverProc, long *refcon)Movie Movie reference.MovieRgnCoverProc Returns the uncover proc for the movie.MovieRgnCoverProc Returns the cover proc for the movie.long Returns the refcon for the cover procedures.Errors invalidMovie -2010 Your movie reference is bad. Image Compression EnhancementsThe Image Compression has four new calls, and it's performance has been increased. Both the Photo CD and JPEG decompressors have been upgraded to directly support the clipping of images. This greatly decreases the time necessary to display large images. In particular, it makes it much easier to work with high resolution Photo CD images. Now, we will discuss the four new calls.SetSequenceProgressProcSetSequenceProgressProc allows you to set a progress procedure on a Compression or Decompression Sequence, just as in the past you could have a progress procedure when compressing or decompressing a still image. pascal OSErr SetSequenceProgressProc(ImageSequence seqID, ProgressProcRecord *progressProc)seqID Sequence identifier.progressProc Pointer to a record containing information about the application's progress proc.The Image Compression Manager has 3 additional calls which allow applications to zoom a monitor. They are considered low-level calls (comparable to SetEntries) that should only be used when playing back QuickTime movies in a controlled environment with no user interaction. Also, because this capability is not present on all machines, applications should not depend on its availability.The new calls provide a standard way for developers to access the 2x mode of a user╒s monitor for playback. Effectively, this allows you to have full screen Compact Video playback on low end Macintosh computers.Hardware 200% resize is currently available only on the Macintosh LC II, IIvx, IIvi, Performa 400, Performa 600, and Color Classic in 16-bit (thousands of colors) display mode on the 12-inch (512 x 384 pixels) monitors. In the future, other graphic devices may take advantage of it.To implement this functionality, the Image Compression Manager actually make calls to the Video Driver for the given device. Video card manufacturers interested in supporting this functionality in their cards should link DEVSUPPORT for more information.GDHasScaleGDHasScale returns the closest possible scaling that a particular screen device can be set to in a given pixel depth. It returns scaling information for a particular GDevice for a requested depth. It allows you to query a GDevice without actually changing it. For example, if you specify 0x20000, but the GDevice does not support it, GDHasScale will return with noErr, and a scale of 0x10000. Remember, it checks for a supported depth, so your requested depth must be supported by the GDevice. GDHasScale references the video driver through the graphics device structure.For multiple screens, see "Multiple Screen Revealed" in develop 10 to find out how to walk the GDeviceList.pascal OSErr GDHasScale(GDHandle gdh,short depth,Fixed *scale)gdh a handle to a screen graphics device. depth pixel depth of screen device. Use this field to specify which pixel depth that scaling information should returned for.scale a pointer to a fixed point scale value. On input, this field should be set to the desired scale value. On output, this field will contain the closest scale available for the given depth. A scale of 0x10000 indicates normal size, 0x20000 indicates double size, etc.Errors cDepthErr The requested depth is not supported.cDevErr Not a screen device.controlErr Video driver can not respond to this call.GDGetScaleGDGetScale returns the current scale of the given screen graphics device.pascal OSErr GDGetScale(GDHandle gdh,Fixed *scale,short *flags)gdh a handle to a screen graphics device.scale pointer to a fixed point field to hold the scale resultflags pointer to a short. It returns the status parameter flags for the video driver. For now, zero is always returned in this field.Errors cDevErr Not a screen device.controlErr Video driver can not respond to this call.GDSetScaleGDSetScale sets a screen graphics device to a new scale.pascal OSErr GDSetScale(GDHandle gdh,Fixed scale,short flags)gdh a handle to a screen graphics device.scale a fixed point scale value.flags always pass zero.Errors cDevErr Not a screen device.controlErr Video driver can not respond to this call.Base Media Handler EnhancementsThe Base Media Handler interface has been extended with 3 new calls, and a new flag. These features were added to provide high quality movie playback. The text media handler takes advantage of these new calls, and provides built-in support for anti-aliased text. It is achieved through a playback hint to the base media handler, which the Apple Text Media Handler derives. This hint, hintsHighQuality, has been discussed in the Movie Toolbox Enhancements section above.The MediaSetHints and MediaGetOffscreenBufferSize routines were added to the Derived Media Handler interface to support high quality mode. Since the Apple Text Media Handler derives the base media handler, it can use these new calls to support anti-aliased text.MediaSetHintsWhen SetMoviePlayHints or SetMediaPlayHints is called by an application, your media handler╒s MediaSetHints routine is called. This allows you to implement appropriate behavior for the various media hints such as scrub mode and high quality mode.pascal ComponentResult MediaSetHints (ComponentInstance ci, long hints)ci Component instance of a base media handler.hints All hint bits the currently apply to the given media.Errors badComponentInstance 0x80008001 Get a new component instanceMediaGetOffscreenBufferSize Before the Base Media Handler allocates an offscreen buffer for your Derived Media Handler, it calls your MediaGetOffscreenBufferSize routine to allow your media handler to chose the dimensions of the buffer. The depth and color table that will be used for the buffer are also passed. When you are called the rectBounds parameter specifies the size that the Base Media Handler will use for your offscreen by default. You can modify this as appropriate before returning. This capability is useful if your media handler can only draw at particular sizes. It is also useful for implementing anti-aliased drawing as you can request a buffer that is larger than your destination area, and have the Base Media Handler scale the image down for you. pascal ComponentResult MediaGetOffscreenBufferSize (ComponentInstance ci, Rect *rectBounds, short depth, CTabHandle ctab)ci Component instance of a base media handler.Rect The boundaries of your off-screen buffer.depth Depth of the offscreen.ctab Color table associated with off-screen. You can set it to nil.Errors badComponentInstance 0x80008001 Get a new component instance.MediaGetNameMediaGetName let's you retrieve the name of the media type. For example, the video media handler will return the string "Video".pascal ComponentResult MediaGetName(MediaHandler mh, Str255 name, long requestedLanguage, long *actualLanguage )ComponentInstance The base media handler instance.Str255 The name of the media type.Long A bunch of flags.Errors badComponentInstance 0x80008001 Get a new component instance.Text Media Handler EnhancementsThe text media handler interface includes 6 new flags, and one new routine. The flags let you control the behavior of the text media handler. The display flags are used in conjunction with the AddTESample and AddTextSample routines. The display flags are passed in the displayFlags parameter.dfContinuousScroll is a display flag which tells the Apple Text Media Handler to let new samples cause previous samples to scroll out.dfFlowHoriz is a display flag which tells the Apple Text Media Handler to let horizontally scrolled text to flow within the text box. This behavior contrasts with letting text flow as if the text box had no right edge.dfDropShadow is a display flag which tells the Apple Text Media Handler to support true drop shadows. Using SetTextSampleData, the position and translucency of the drop shadow is under application control.dfAntiAlias is a display flag which tells the Apple Text Media handler to attempt to display text anti-aliased.dfKeyedText is a display flag which tells the Apple Text Media handler to render text over the background without drawing the background color. This technique is otherwise known as "Masked Text."enum {dfContinuousScroll = 1<<9, dfFlowHoriz = 1<<10,dfDropShadow = 1<<12, dfAntiAlias = 1<<13, dfKeyedText = 1<<14};findTextUseOffset is a new find text flag which instructs FindNextText to look at the value pointed to by the offset parameter and start the search at that offset into the text sample indicated by startTime. This allows you to continue a text search from within a given sample, so that multiple occurrences of the search string can be found within a single sample.findTextUseOffset = 16; SetTextSampleDataSetTextSampleData allows you to set values prior to calling AddTextSample or AddTESample. Two types are currently supported: 'drpo' and 'drpt'. The first type, 'drpo', is the drop shadow offset. Pass the address of a point for the data parameter. 'drpt' is the drop shadow translucency. Pass a value from 0 to 255, where 0 is the lightest and 256 is the darkest.pascal ComponentResult SetTextSampleData(MediaHandler mh, void *data, OSType dataType)mh Reference to the text media handler. Could use GetMediaHandler.data Pointer to data, defined by dataType parameter. handleType Sets the type of data in the handle. For now, either 'drpo' or 'drpt'.Errors badComponentInstance 0x80008001 Your media handler reference is hosed.Here is some sample pseudo-code (it might not compile):short trans = 127;Point dropOffset;dropOffset.h = dropOffset.v = 4;SetSampleData(mh,(void *)&dropOffset,'drpo');SetSampleData(mh,(void *)&trans,'drpt');Be sure to turn on the dfDropShadow display flag when you call AddTextSample or AddTESample.Import/Export Component EnhancementsExport components have one new flag, one new error, two new functions, one new data structure, one new component, and an enhancement to the Sound Export component. The Text Movie export component was introduced above. Import components have one new function. The Audio CD Movie Import component was already introduced.canMovieExportAuxDataHandle is a movie export component flag. A Movie Export Component that supports the MovieExportGetAuxiliaryData call should also now set the canMovieExportAuxDataHandle flag in its ComponentFlags. canMovieExportAuxDataHandle = 128The error auxiliaryExportDataUnavailable has been added. It will be returned by a Movie Export Component when MovieExportGetAuxiliaryData is called requesting a type of auxiliary data that the component cannot generate. auxiliaryExportDataUnavailable = -2058The Sound Movie Export component has been updated to take advantage of the new Sound Manager. Previously, only the first sound track in the movie was exported. Now sound tracks are mixed together before being exported. If your application wants to take advantage of the sound mixing, you can use PutMovieIntoTypedHandle. It will take advantage of the export component. Furthermore, you can now specify the format of the exported sound, so you can convert 16 bit sound to 8 bit sound, or reduce stereo to mono.MovieExportSetSampleDescriptionMovieExportSetSampleDescription allows an application to request the format of the exported data, the routine MovieExportSetSampleDescription has been added. This call is currently supported by the Movie Export Sound Component.pascal ComponentResult MovieExportSetSampleDescription(MovieImportComponent ci, SampleDescriptionHandle desc, OSType mediaType)ci Component Instance of movie import component.desc Handle to a valid QuickTime sample description.mediaType The type of the media that the sample description is from.Errors badComponentInstance 0x80008001 Get a new component instance.MovieImportGetAuxiliaryDataTypeMovieImportGetAuxiliaryDataType should return the type of the auxiliary data that it can accept. This is useful if you are interested with import components directly. For example, if you call the text import component with this call, it will indicate that it can accept 'styl' information.pascal ComponentResult MovieImportGetAuxiliaryDataType(MovieImportComponent ci, OSType *auxType)ci The movie import component instance. Retrieve it with OpenDefaultComponent or OpenComponent.auxType Pointer to the type of auxiliary data it can import. For example, a text import component can bring in 'text' data. But, if it says it can return 'styl', then it will import the style information as well.Errors badComponentInstance 0x80008001 Your movie import component reference is bad.Here is a new data structure for the text export component. This data is useful after a text track has been exported. An application may want to know the way the text was stored as a track.typedef struct { long displayFlags; long textJustification; RGBColor bgColor; Rect textBox; short beginHilite; short endHilite; RGBColor hiliteColor; Boolean doHiliteColor; TimeValue scrollDelayDur; Point dropShadowOffset; short dropShadowTransparency;} TextDisplayData;TextExportGetDisplayDataTextExportGetDisplayData returns the text display data for the text sample that was last exported by the given text export component. After exporting text from a text track, it is often useful to find out about the text track characteristics. This data structure contains this extra information.pascal ComponentResult TextExportGetDisplayData(TextExportComponent ci, TextDisplayData *data)ci The text export component instance. Retrieve it with OpenDefaultComponent or OpenComponent.displayData Pointer to the text display data.Errors badComponentInstance 0x80008001 Your movie import component reference is bad.ColorSyncColorSync is an extension for Macintosh providing a platform for consistent color reproduction between widely varying output devices. Color Matching ability was added to the Image Compression Manager DrawPicture calls. Accurate color reproduction of images (not movies) is made easier with QuickTime╒s flexible DrawPicture calls. To enable color matching you simply set the useColorMatching flag in the flags parameter to these calls. You can set the flag even when ColorSync is not installed, although it will be ignored. useColorMatching = 4Sequence Grabber EnhancementThe Sequence Grabber component has just one flag added to it. grabPictCurrentImage is a new flag to the SGGrabPict call. It provides the fastest possible image capture, but may fail under certain circumstances. This failure is not fatal; it just will not return a picture. The routine does not pause the current preview or grab the next frame. It causes the currently displayed image to be captured. It is a good idea to call SGPause yourself before calling SGGrabPict with this flag. grabPictCurrentImage = 4Image Codec EnhancementThe interface for image codecs has three new functions and one new flag defined. codecConditionFirstScreen is a new codec condition flag to the ImageCodec.h file. #define codecConditionFirstScreen (1L<<12)The Standard Compression Dialog now provides Compressor Components with the option of displaying their own settings within the dialog. If a compressor supports the dialog, an additional button will appear. The compressors settings are saved with the standard compressor settings when the SCGetInfo call is used with the scCodecSettingsType flag. The codec can implement the functionality using the following three routines. CDRequestSettingsCDRequestSettings allows the display of a dialog of additional compression settings specific to the codec. This information is stored in a settings handle. The codec can store whatever data in any format wants in the settings handle and resize it accordingly. It should store some type of tag/version information that it can use to verify that the data belongs to the codec. The codec should NOT dispose the handle.pascal ComponentResult CDRequestSettings(ComponentInstance ci, Handle settings, Rect *rp, ModalFilterProcPtr filterProc)ci Component instance of codec.settings Handle of data specific to the codec. If the handle is empty, the codec should use some type of default settings. rp Pointer to rectangle giving the coordinates of the Standard Compression dialog in screen coordinates. The codec can use this to position its dialog in the same area of the screen.filterProc A pointer to modal dialog filter proc that the codec must either pass to ModalDialog or call at the beginning of the codec dialog's filter. This proc gives the calling application and Standard Compression a chance to process update events.CDGetSettingsCDGetSettings allows a codec to get the settings chosen by a user. From this call, the codec should return its current internal settings. If there are no current settings or the settings are the same as the defaults, the codec can set the handle to empty.pascal ComponentResult CDGetSettings(ComponentInstance ci, Handle settings)ci Component instance of codec.settings A handle that the codec should resize and fill in with the current internal settings. It should be resized to empty if there are no current internal settings.CDSetSettingsCDSetSettings allows a codec to set the settings of the optional dialog. Set the codecs current internal settings to the state specified in the settings handle. The codec should always do a validity check on the contents of the handle so that invalid settings are never used.pascal ComponentResult CDSetSettings(ComponentInstance ci, Handle settings)ci Component Instance of movie import component.settings A handle to internal settings original returned by either the CDRequestSettings or CDGetSettings calls. The codec should set it's internal settings to match those of the settings handle. Because the codec does not own the handle, it should not dispose of it, and should only copy its contents, not the handle itself. If the settings handle passed in is empty, the codec should set its internal settings to a default state.New Component Manager FeaturesThe Component Manager in QuickTime 1.6 has some new features. The result returned for the selector, gestaltComponentMgr, will be 3, indicating version number 3 of the Component Manager. It has added the ability to automatically resolve conflicts between different versions of the same Component. It will ensure that only the most recent version of a given component is actually registered. In addition, the Component Manager now supports Icon Suites for a Component, so a Component╒s icon no longer has to be just black and white. The ComponentResource data structure can now have an optional extension. This extension defines additional information about the Component. The data structure is shown below.struct ComponentResourceExtension { long componentVersion; /* version of Component */ long componentRegisterFlags; /* flags for registration */ short componentIconSuite; /* resource id of Icon Suite */};typedef struct ComponentResourceExtension ComponentResourceExtension;The ComponentResourceExtension is appended to the end of existing ComponentResource structures. The Component Manager determines if it is present by examining the size of the resource.The componentVersion field contains the version number of the component. This should be identical to the value returned by GetComponentVersion. For convenience, if this value is set to 0, the component is called to get the version. This is useful during development. The version number stored in the ComponentResourceExtension is used by the Component Manager to avoid having to load and call the Component to retrieve the Component╒s version during startup.The componentRegisterFlags allow you to define additional register information. These flags are shown below. // Component Resource Extension flagsenum { componentDoAutoVersion = 1<<0, componentWantsUnregister = 1<<1, componentAutoVersionIncludeFlags = 1<<2};The componentDoAutoVersion flag tells the Component Manager that you only want your Component registered if there is no later version available. If there is an older version of the Component installed, it will be unregistered. If an older version of the same Component attempts to register after you, it will be immediately unregistered. Further, if a newer version of the same Component registers after you, you will automatically be unregistered. Using the automatic version control feature of the Component Manager allows you to make sure that only the most recent version of your software is running on a given machine, regardless of how many versions many be installed.The componentWantsUnregister flag indicates that your Component wants to be called when it is unregistered. This is useful if your component allocates global memory at register time, for example. The prototype of the unregister message is identical to the register message. If your component has never been opened, its unregister message will not be called. The routine selector for unregister is given below.The componentAutoVersionIncludeFlags flag tells the Component Manager to use the component flags as criteria for it's component search. If a component wants automatic version control, the Component Manager has to search for similar components. Normally, the Component Manager only searches for another component using the type, subType, and manufacturer fields of a ComponentDescription record. This flag tells the Component Manager to include the componentFlags in its search.#define kComponentUnregisterSelect -7 Finally, the componentIconSuite field allows you to provide the resource id of a System 7 Icon Suite. If this field is 0, it indicates that there is no icon suite. GetComponentIconSuiteGetComponentIconSuite returns an Icon Suite for the given Component. This call only works on System 7 or later. If called on System 6, it returns an error. If the Component doesn╒t have an Icon Suite but does have a Component Icon (as returned by GetComponentInfo), GetComponentIconSuite creates an Icon Suite containing just the black and white Component Icon. In this way, you can use GetComponentIconSuite without regard to whether or not a Component has an Icon Suite or just simply a Component Icon.For more details on Icon Suites, see the Tech Note on Icon Suites (M.IM.IconDrawing), "Drawing Icons the System 7 Way".pascal OSErr GetComponentIconSuite(Component aComponent, Handle *iconSuite)aComponent Component id, retrieved with FindNextComponent.iconSuite Pointer to the icon suite you will receive.Errors invalidComponentID -3000 Component reference is not valid.QuickTime 1.6 Bug FixesQuickTime 1.6 fixes all known bugs in QuickTime 1.5. Many of these bugs are listed below.Movie ToolboxÑ╩The Movie Toolbox interesting time calls have been substantially improved. The values returned are much more consistant and accurate.Ñ╩GetMoviePict has two major improvements:GetMoviePict no longer fails on certain Compact Video movies.GetMoviePict now reports out of memory errors rather than returning empty pictures when memory is low.Ñ╩UpdateMovieResource has been fixed for single fork files.Ñ╩Editing movie's with alternate tracks no longer causes duplicate tracks to be created.Ñ╩Movie Uncover Procedures have been significantly improved. If a movie with tracks that are semi-transparent has a Movie Uncover procedure set (by SetMovieCoverProcs), the uncover procedure is now called before each frame to fill/erase the background. Previously the Movie Toolbox performed the erase, which limited a cover procedure aware application's options.Ñ╩The dialog sequence that appears when a movie data file is lost has been reworked to eliminate the "This is not a valid movie file" dialog.Ñ╩Fixed problem with deactivating and reactivating Compact Video movies that caused ╥shimmering╙ effects in the image.Ñ╩GetMoviePosterPict now properly handles tracks which are only in the poster and not in the movie.Ñ╩Movies played in loop mode using the Movie Controller no longer briefly pause when they jump from the end back to the beginning of the movie.Movie ControllerÑ╩The Movie Controller performs much smarter drawing, so it takes up less time during movie playback.Ñ╩The Movie Controller no longer leaves the port clip changed after drawing the badge.Movie Import/ExportÑ╩The Import AIFF Sound File to Movie component now always imports the entire file.Ñ╩The PICT and PICS import components no longer scale down images larger than the screen.Text Media HandlerÑ╩When multi-line text is grown, lines after line 1 were not displayed. The bug did not occur when grown exactly 2x. It is now fixed.Ñ╩Empty text samples sometimes caused the Text Media Handler to lose track of subsequent text size. It is now fixed.Ñ╩FindText did not do "case insensitive" searches properly. Furthermore it tried to dispose of the text string that was passed in. It is now fixed.Ñ╩FindText "wrap around" search did not always work properly. It now does.Ñ╩Hilite text samples did not always display properly. They now do.Ñ╩If the track contained multiple text descriptions, performance was sometimes severely degraded -- not anymore.Ñ╩Text clipping and scrolling is now much more reliable.Image Compression ManagerÑ The AlignWindow call has been fixed to respect vertical repositioning.Compact VideoÑ In some cases, the Compact Video compressor allowed the data rate to exceed the limit set by the calling application, causing playback problems from CD. QuickTime 1.6 fixes this bug.Ñ Decompressing gray scale Compact Video data to an 8-bit color destination no longer crashes.Photo CD DecompressorÑ More accurate colors in decompression are displayed.Standard CompressionÑ If scAllowZeroFrameRate is true, default to 0 frame rate.Ñ The key frame rate now updates correctly when changed from hook procedure.Ñ Rate-constrain item checked if non-zero default value present.Sequence GrabberÑ Sound wouldn╒t get restarted or turned off correctly if the record bit wasn╒t set in its channel usage. It is now fixed.Ñ Video panel does not bus error if the digitizer doesn't support hue.Component ManagerÑ The Component Manager no longer changes the current resource file when loading a Component.Ñ The Component Manager now tracks files using File ID's when possible, rather than FSSpec's.Ñ Fixed obscure boot problem that would hang the machine when a component was called to register and the system heap was extremely low on free memory.Ñ It is now OK to pass an empty handle to GetComponentInfo. This is helpful, since it can return them.Further Reference:Ñ Inside Macintosh, QuickTimeÑ Inside Macintosh, QuickTime Componentsα ╫# # ╫ í d WORD S╩ á î í d WORD R╔ á é
6 6 ê
0Iê:╡£≡9 " é÷ # á ─ í d
ONLN f ■ á î í d 1drw2 ╔ -ß_ Ç Å í û x í d drw2 : í d drw2 : $ í d 4drw2 : í Ü · ù@ á ÿ , Times . WIQkWIQk +9INew Technical Notes á Ö í d drw2 : íπ á ù í d 1drw2 e⌠ Ç P í û x í d drw2 : í d drw2 : $ í d 4drw2 : í Ü √Ç E└ á ÿ ! ( éqDeveloper Support á Ö í d drw2 : íπ á ù í d `drw2 - ∩ K ∩ - Z m° m 6 í d 1drw2 ╩└·Θ K í û x í d drw2 : í d drw2 : $ í d 4drw2 : 0 í Ü ⌠ Ç á ÿ 0 ( \╦≡ á Ö í d drw2 : íπ á ù í d 1drw2 ∩µ·≡ í û x í d drw2 : í d drw2 : $ í d 4drw2 : í Ü ²Ç á ÿ l +& ¿ á Ö í d drw2 : íπ á ù í d 1drw2 σ -° y í û x í d drw2 : í d drw2 : $ í d 4drw2 : í Ü √Ç % á ÿ BÇ ( a 8 Macintosh á Ö í d drw2 : íπ á ù á ì í d drw2 D á â í d WORD á ì
d . í d ONLN d v ê ╥ ( ú 6QuickTime 1.6 Features í d ONLN d û ñ \ * QuickTime í d ONLN d ! ûü ñ┌ ( └ƒQuickTime 1.6 í d ONLN d 2 ░Ñ ╝┌ +$ April, 1993 í d ONLN d > ╚ ╘ ╚ ( ≡ 6'This note is a technical discussion of í d ONLN d e ╚ ╚ ╘┌ )░4the changes between QuickTime 1.5 and QuickTime 1.6. í d ONLN d Ü ╘ α f ( ⁿ 6QuickTime 1.6 í d ONLN d ¿ ╘ f α┌ )NGintroduces some new features, and is more reliable than other QuickTime í d ONLN d ≡ α ∞╦ ( 6Xversions. The note also discusses the new features of QuickTime 1.6's Component Manager. í d ONLN dI ° ; *Topics í d ONLN dP 3 7 + Ñ í d ONLN dR < ┤ ) QuickTime 1.6 Features: í d ONLN dl ≡╡ )┤)Describes how to access the new features. í d ONLN dû 3 7 (8 QÑ í d ONLN dÿ < π ) Component Manager 3.0 Features: í d ONLN d╣ ≡ ╡ )┤)Describes how to access the new features. í d ONLN dπ 3( 7 (D QÑ í d ONLN dσ <( ╜ ) QuickTime 1.6 Bug Fixes: í d ONLN d ≡(b )┤Describes the bug fixes. _ 4_∙ í d ONLN d_ q ╥ (î 6QuickTime 1.6 Features É 4É∙ í d ONLN d0 ï ╙ *&The new features of QuickTime 1.6 are í d ONLN dV ╙ï┌ )╗7fully described in this note. These new features can be í d ONLN dÄï ù h (│ 6logically divided í d ONLN dáï hù┌ )PIinto two sections: "Features You Get For Free" and "Features You Get With í d ONLN dΩù ú W (┐ 6 Some Code." í d ONLN d≈» ╗P *@This documentation assumes the reader is QuickTime-literate. If í d ONLN d7»P╗┌ (╫nthis documentation does not í d ONLN dS╗ ╟ V (π 6suffice, refer í d ONLN db╗ V╟ c )>to í d ONLN de╗ c╟ ≥ )Inside Macintosh: QuickTime í d ONLN dÇ╗ ≥╟ )Å and í d ONLN dà╗ ╟┌ )&Inside Macintosh: QuickTime Components í d ONLN d¼╟ ╙2 (∩ 6;which are currently available from APDA. In addition, most í d ONLN dτ╟2╙┌ (∩P QuickTime questions are answered í d ONLN d╙ ▀ (√ 61through rummaging through the sample code and/or í d ONLN d9╙▀┌ ) %applications on the QuickTime 1.5 CD. í d ONLN d_▀ δ7 ( 6<Also, the QuickTime 1.0 CD serves as an excellent reference. í d ONLN d£≈ Ω * Features You Get For Free ( 4(∙ í d ONLN d╢ # 3 *This í d ONLN d╗ 3#┌ )Psection describes the features of QuickTime 1.6 which are added transparently to í d ONLN d # / ≡ (K 6-QuickTime. In general, your application will í d ONLN d9# ≡/┌ )╪/not have to do anything to your application for í d ONLN di/ ; ╔ (W 6&these features. But the user may have í d ONLN dÅ/ ╔;┌ )▒;to install a specific extension and/or have the appropriate í d ONLN d╦; G╛ (c 6Requipment. QuickTime 1.6 exploits these extensions: Sound Manager, Macintosh Easy í d ONLN d ;╛G┌ (c▄Open, í d ONLN d#G S (o 63and ColorSync. In addition, it exploits the CD ROM í d ONLN dVGS┌ )·'300(i), grayscale PowerBooks, Macintosh í d ONLN d~S _ù ({ 6RLC II class machines, Quadras, and stereo output devices. The exact nature of the í d ONLN d╨Sù_┌ ({╡exploitation is í d ONLN dα_ k ╙ (ç 6(discussed in the various sections below. í └⌠%%DSIDICT:_cvcurrentdict /bu known {bu}ifuserdict /_cv known not{userdict /_cv 30 dict put}if_cv begin/bdf{bind def}bind defcurrentscreen/cs exch def/ca exch def/cf exch def/setcmykcolor where{/setcmykcolor get /cvcmyk exch def}{/cvcmyk{1 sub 4 1 roll 3{3 index add neg dup 0 lt{pop 0}if 3 1 roll}repeat setrgbcolor pop}bdf }ifelse/ss{//cf //ca //cs setscreen}bdf/stg{ss setgray}bdf/strgb{ss setrgbcolor}bdf/stcmyk{ss cvcmyk}bdf/min1{dup 0 eq{pop 1}if}bdfendcurrentdict /bn known {bn}if á ┐░ ╫# # ╫
d , Times
. +6,Macintosh Technical Notes . 4 .∙ í d ONLN d ( 6 ┬ *&Reduced Memory Footprint U 4 U∙ í d ONLN d C O╘ *WQuickTime 1.6 code has been segmented. QuickTime's code segmentation allows unused code í d ONLN d q O [┼ * Xsegments to be unloaded when not in use. QuickTime 1.6 uses less than 18k when installed í d ONLN d ╩ [ g * .whereas QuickTime 1.5 used approximately 160k. í d ONLN d ∙ s └ *ZBecause of this segmentation, substantially less memory is required for movie playback. If í d ONLN dT ï╠ * ]applications are not using a particular functionality, the corresponding code segments may be í d ONLN d▓ ï ù╛ * Yunloaded. For example, movie editing code will not be loaded unless the movie application í d ONLN d ù ú J * requires it. í d ONLN d ╗ ╔ ─ *&Sound Manager 3.0 Support Φ 4 Φ∙ í d ONLN d4 ╓ Γ █ *'QuickTime 1.6 is released with the new í d ONLN d[ ╓ █ Γ┌ )├/Sound Manager, Version 3.0. Since the new Sound í d ONLN dï Γ εú (
6NManager completely replaces the existing Sound Manager, it will work with all í d ONLN d┘ Γú ε┌ (
┴ versions of í d ONLN dσ ε ·F ( 6?QuickTime and all existing applications. If the Sound Manager í d ONLN d$ εF ·┌ (d 3.0 is installed, QuickTime 1.6 í d ONLN dD · ╬ (" 6)will take advantage of it's new features. í d ONLN dn } *GYou can use QuickTime with the Sound Manager 3.0 in the following ways: í d ONLN d╢* !6 + 5Ñ Spit multiple sound tracks into one sound resource í d ONLN d∞6 3B* + 1The best feature of the new Sound Manager is the í d ONLN d 6*B┌ )≈$ability to mix multiple sound tracks í d ONLN dBB 3N º (j Qinto one sound resource. í d ONLN d[Z !f ¬ (é ? Ñ╩Play sound more efficiently í d ONLN dyf 3rû + GThe new Sound Manager lessens the load on the CPU for sound. As a rule í d ONLN d└fûr┌ (Ä┤of thumb, you í d ONLN d╬r 3~d (Ü QBwill be able to get one extra frame per second for video playback. í d ONLN dè !û ▐ (▓ ?(Ñ╩Support alternate sound output devices í d ONLN d:û 3óö + EThis allows you to hook up hardware to your Macintosh for CD quality í d ONLN dûöó┌ (╛▓16-bit 44 kHz í d ONLN dìó 3« ô (╩ Qstereo sound output. í d ONLN dó║ !╞ (Γ ?3Ñ╩Allow better control over multiple sound channels í d ONLN d╓╞ 3╥ t + With Sound í d ONLN dß╞ t╥┌ )ADManager 3.0, sound overdriving is now possible. By setting the movie í d ONLN d&╥ 3▐8 (· Q8volume above 1.0, the sound will actually be overdriven. í d ONLN d`Ω !÷ % ( ?Ñ í d ONLN dbΩ *÷ » ) Support true balance control í d ONLN d ! % (* ?Ñ í d ONLN dü *═ ) WHandle sound mixing better, which improves the quality of multiple sound track playback í d ONLN d┘ !& % (B ?Ñ í d ONLN d█ *& ╩ ) Use the new Sound Control Panel í d ONLN d√> L ═ (h 6Compact Video Enhancement k 4k∙ í d ONLN dY eí *RCompact Video playback to 16 bit destinations (thousands of colors) is now higher í d ONLN dgYíe┌ (ü┐ quality. The í d ONLN dte q (ì 64dithering algorithm has been significantly improved. ▀ 4▀∙
*e2 ) of 18 (≥æQuickTime 1.6 Tech Note ¿ ╫# # ╫
d , Times
. +6,Developer Technical Support ( ,╠
April 1993 . 4 .∙ í d ONLN d ( 6 ä ( R 6Audio CD Import U 4 U∙ í d ONLN d C O j *A Movie Import í d ONLN d C j O┌ )RDcomponent has been provided which allows you to open Audio CD tracks í d ONLN d d O [ í ( w 6from QuickTime╒s Standard í d ONLN d ~ O í [┌ )ë?File Preview dialog, just as you could open PICS and AIFF files í d ONLN d ╛ [ gÑ ( â 6Mwith QuickTime 1.5. If you have a Apple CD 300 or CD 300i drive, you can use í d ONLN d [Ñ g┌ ( â├ QuickTime í d ONLN d g sÄ ( Å 6O1.6 to convert tracks of your favorite audio CD directly into QuickTime movies.
₧ îó , Geneva cóKycóKy í d ONLN d +⌐║QuickTime¬ and a í d ONLN d (U ╧Graphics decompressor í d ONLN d (a ╕! are needed to see this picture
d í d ONLN dfⁿ
R (& 6
Figure 1. í d ONLN dp■ R
):'When you try to open an audio track on í d ONLN dù■
┌ )┐(a CD 300(i), the Open button will change í d ONLN d└
╔ (2 6Uto a Convert╔ button. When you click this button, the Audio CD Import Options dialog í d ONLN d
╔┌ (2τwill í d ONLN d " (> 66pop up. With this dialog, you can configure the sound í d ONLN dP"┌ (>7*settings of the movie. The rate, size, and í d ONLN d{" . æ (J 6channel can be specified í d ONLN dö" æ.┌ )yDfor the movie. In addition, you can select the portion of the track í d ONLN d┘. :D (V 6?which should become a movie. You can select the start time and í d ONLN d.D:┌ (Vb end time for the track. You can í d ONLN d8: F= (b 6?play your selection to be sure you have the selection you want. í d ONLN dxb p ë **Text Track Export Å 4Å∙ í d ONLN dè} ë├ *WA Text Movie Export component lets you easily extract text from movies. With Macintosh í d ONLN dß}├ë┌ (ÑßEasy í d ONLN dµë ò ╓ (▒ 6)Open installed, you can copy a series of í d ONLN dë ╓ò┌ )╛6text frames from a movie, and paste them directly into í d ONLN dFò í (╜ 60any application that supports text, such as MPW. ▀ 4▀∙
*5QuickTime 1.6 Tech Note (≥█3 ) of 18 ö ╫# # ╫
d , Times
. +6,Macintosh Technical Notes . 4 .∙ í d ONLN d * 8 ╥ *(Macintosh Easy Open Support W 4 W∙ í d ONLN d E Q R *
QuickTime í d ONLN d & E R Q┌ ):G1.6 fully supports Macintosh Easy Open. Macintosh Easy Open is an Apple í d ONLN d o Q ]x ( y 6Gsystem extension which provides document and clipboard translation for í d ONLN d ╢ Qx ]┌ ( yûall applications. If a í d ONLN d ═ ] i D ( à 6 user has í d ONLN d ╓ ] D i┌ ),NMacintosh Easy Open installed in combination with QuickTime 1.6, then they can í d ONLN d% i u ( æ 65copy and paste various media formats without thought. í d ONLN d[ ü ì */QuickTime 1.5 contained translation components í d ONLN dè ü ì┌ )Ω+for importing and exporting movie data from í d ONLN d╢ ì Ö8 ( ╡ 6<files and the clipboard. QuickTime 1.6 provides a Macintosh í d ONLN d≥ ì8 Ö┌ ( ╡V Easy Open translation component í d ONLN d Ö Ñ¬ ( ┴ 6Lwhich makes all QuickTime movie import/export components work automatically í d ONLN d^ Ö¬ Ñ╓ ( ┴╚with non í d ONLN df Ö╓ Ñ┌ ),- í d ONLN dg Ñ ▒ ( ═ 63QuickTime-aware applications. For example, you can í d ONLN dÜ Ñ ▒┌ )²(paste a sound track into a Sound Editing í d ONLN d├ ▒ ╜╜ ( ┘ 6[application, and it will translate the format from a QuickTime sound movie to a sound file. í d ONLN d ╔ ╒ f *QuickTime 1.6 í d ONLN d- ╔ f ╒┌ )NGincludes support for importing sound, PICTs, and PICS. It also supports í d ONLN du ╒ ß^ ( ² 6?exporting movies to PICT and sound. Additional MovieImport and í d ONLN d┤ ╒^ ß┌ ( ²|MovieExport components í d ONLN d╦ ß φ¬ ( 6Ocan be found on the QuickTime 1.5 Developer CD in the Sample Components folder. í d ONLN d ┤ *&Tear-free Movie Playback 2 42∙ í d ONLN d4 ,w *FSupport has been added to the Image Compression Manager to reduce the í d ONLN dz w,┌ (Hòtearing that is visible í d ONLN dÆ, 8 ╚ (T 6$when playing back movies with large í d ONLN d╢, ╚8┌ )░5amounts of motion. The feature only works on machines í d ONLN d∞8 DU (` 6Ewith fast screen access, so it isn╒t usually enabled for NuBus video í d ONLN d18UD╓ (`s cards. Typically, better tear í d ONLN dN8╓D┌ )ü- í d ONLN dOD P ╣ (l 6!free movie playback will be seen í d ONLN dpD ╣P┌ )í5on Compact Video movies in 16-bit on a Quadra. A good í d ONLN dªP \ µ (x 6,movie to look to see the improvement is the í d ONLN d╥P µ\┌ )╬,beginning of ╥Everybody Loves Me But You╙ on í d ONLN d \ h ║ (ä 6 the QuickTime 1.5 Developer CD. í d ONLN d Ç Ä *&%PowerBook Movie Playback Enhancements ¡ 4¡∙ í d ONLN dE¢ º ± **The PowerBooks which use 4-bit gray scale í d ONLN do¢ ±º┌ )┘*(PowerBook 160, 180, Duo 210, Duo 230) are í d ONLN dܺ │ (╧ 66supported using new fast dithering. All decompressors í d ONLN d╨º │┌ (╧:)transparently take advantage of this fast í d ONLN d·│ ┐ E (█ 6
dithering. í d ONLN d╫ σ _ *& YUV Codec 4∙ í d ONLN d≥ ■ ╞ * A YUV Compressor/Decompressor í d ONLN d-≥ ╞■┌ )«4Component has been added to QuickTime 1.6. It stores í d ONLN db■
: (& 6data in í d ONLN dj■ :
┌ )"UYUV 4:2:2 format. The compression algorithm is not lossless, but the image quality is í d ONLN d└
b (2 6Bextremely high. The compression ratio is 2:1. It does not support í d ONLN d
b┌ (2Çframe differencing. It is í d ONLN d " (> 6;useful with certain video input solutions. In addition, it í d ONLN dW"┌ (>8)is also useful as an intermediate storage í d ONLN dü" .[ (J 6Gformat if you are applying multiple effects or transitions to an image. í d ONLN d╔: F| *GBy default, YUV does not appear in the Standard Compression dialog. If í d ONLN d :|F┌ (bÜyou hold down the í d ONLN d "F R╜ (n 6]option key when clicking on the compressor list to display the complete list, it will appear. í d ONLN d Çj |) *) Features You Get With Some Code ¢ 4¢∙ í d ONLN d áè û *This section describes the features of QuickTime í d ONLN d ╤èû┌ )≡(1.6 which are NOT added transparently to í d ONLN d ·û ó µ (╛ 6*QuickTime. Your application will need new í d ONLN d
$û µó┌ )╬4code to take advantage of them. In this section, the í d ONLN d
Yó « ╝ (╩ 6$use of these features are explained. ▀ 4▀∙
*(4 ) of 18 (≥æQuickTime 1.6 Tech Note î ╫# # ╫
d , Times
. +6,Developer Technical Support ( ,╠
April 1993 . 4 .∙ í d ONLN d * 8 ╬ ( T 6Movie Toolbox Enhancements W 4 W∙ í d ONLN d E Qi *DThe Movie Toolbox has three new calls, and two new flags. First, we í d ONLN d _ Ei Q┌ ( mçwill talk about the new í d ONLN d w Q ] Ä ( y 6flag. When using either ,
Courier í d ONLN d Å R Ä ] ≥ )vPasteHandleIntoMovie í d ONLN d ú Q ≥ ] )d or í d ONLN d º R ]r )ConvertFileToMovieFile í d ONLN d ╜ Qr ]ª )n to import í d ONLN d ╚ Qª ]┌ )4 data into a í d ONLN d ╘ ] i Ö ( à 6movie, you can now set the í d ONLN d ∩ ^ Ö i )üshowUserSettingsDialog í d ONLN d ] ik )n flag. This will cause í d ONLN d ]k i┌ )dthe user settings dialog í d ONLN d5 i u` ( æ 6Ifor that import operation to be displayed, if there is one. For example, í d ONLN d~ i` u┌ ( æ~when importing a picture, í d ONLN dÿ u ü ( ¥ 61this would cause the Standard Compression dialog í d ONLN d╔ u ü┌ )±)to be displayed so the compression method í d ONLN d≤ ü ì k ( ⌐ 6could be selected. í d ONLN d ù < ó ╛ +$showUserSettingsDialog = 2 í d ONLN d" ¼ ╖ h ( ╙ 6hintsHighQuality í d ONLN d2 ½ h ╖ £ )P
is a new í d ONLN d< ½ £ ╖ ╫ )4 flag to the í d ONLN dH ¼ ╫ ╖, );SetMoviePlayHints í d ONLN dY ½, ╖I )U and í d ONLN d^ ¼I ╖₧ ) SetMediaPlayHints í d ONLN do ½₧ ╖┌ )U routines. It í d ONLN d} ╖ ├ ▐ ( ▀ 6(specifies that the given movie or media í d ONLN dÑ ╖ ▐ ├┌ )╞2should render at the highest quality. Rendering at í d ONLN d╪ ├ ╧? ( δ 6<highest quality may take considerably more time and memory. í d ONLN d ├? ╧┌ ( δ]!Therefore, this mode is typically í d ONLN d6 ╧ █₧ ( ≈ 6Snot appropriate for real time playback, but is very useful for recompressing as it í d ONLN dë ╧₧ █┌ ( ≈╝ can generate í d ONLN dû █ τ Ç ( 6higher quality images. í d ONLN d« ≤ < ■ » +$hintsHighQuality = 1<<8 í d ONLN d╔ à (1 6The high quality mode í d ONLN d▀ à┌ )mEcan be used with other media handlers as well. For example, the Video í d ONLN d% !Ö (= 6QMedia Handler turns off fast dithering and allows high quality dithering. Now we í d ONLN dvÖ!┌ (=╖will introduce í d ONLN dà! - ╜ (I 6"the three new Movie Toolbox calls. í d ONLN d¿9 !E ╚ + SetMovieDrawingCompleteProc d =d∙ í d ONLN d─Q !\ ¿ *SetMovieDrawingCompleteProc í d ONLN d▀P ¿\å )ç3 lets you set a call back procedure that is called í d ONLN dPå\┌ )▐after a Movie has í d ONLN d$\ !h0 (ä ?6drawn in one or more of its tracks. In this way, your í d ONLN dZ\0h┌ (äN application can be aware of when í d ONLN d{h !t (É ?0QuickTime has drawn frames, and when it hasn╒t. í d ONLN d½h t┌ )²$This information is very useful when í d ONLN d╨t !Ç i (£ ?combined with í d ONLN d▐u iÇ » )HSetTrackGWorld í d ONLN d∞t »Ç δ )F (see below). í d ONLN d·è !ò└ (▒ ?Spascal void SetMovieDrawingCompleteProc(Movie theMovie, MovieDrawingCompleteProcPtr í d ONLN dNö !ƒ { *
proc, long refCon) í d ONLN da¿ !│ I *theMovie í d ONLN dj¿ ä│ )c The Movie to set the proc on. í d ONLN dê▓ !╜ 5 (┘ ?proc í d ONLN dì▓ ä╜j )c.Your call back procedure, or nil to remove it. í d ONLN d╝╝ !╟ ? (π ?refCon í d ONLN d├╝ ä╟V )c*Value to pass to your call back procedure. í d ONLN dε╨ !█╢ (≈ ?Qtypedef pascal OSErr (*MovieDrawingCompleteProcPtr)(Movie theMovie, long refCon); í d ONLN d@Σ !≡ C *Errors í d ONLN dH≡ !√ b * invalidMovie í d ONLN dV≡ ä√ ¥ )c-2010 í d ONLN d\≡ ¿√4 )$ Your movie reference is bad. í d ONLN dy ! { (. ?SetTrackGWorld 1 =1∙ í d ONLN dê ! g *SetTrackGWorld í d ONLN dû g
)F% lets you force a track to draw into í d ONLN d╗
┌ )ú'a particular GWorld. This GWorld may be í d ONLN dπ !+ Ç (G ?different from that í d ONLN d≈ Ç+┌ )_Fof the entire movie. After the track has drawn, it calls your transfer í d ONLN d>+ !7î (S ?Kprocedure to copy the track to the actual movie GWorld. When your transfer í d ONLN dë+î7┌ (S¬procedure is set, í d ONLN d¢7 !C ¿ (_ ? the current GWorld is set to í d ONLN d╕7 ¿C┌ )çBthe correct destination. You can also install a transfer procedure í d ONLN d√C !O E (k ?and set í d ONLN d C EO┌ )$Uthe GWorld to nil. This will result in your transfer procedure being called only as a í d ONLN d YO ![g (w ?Inotification that the track has drawn -- no transfer needs to take place. ▀ 4▀∙
(≥ 6QuickTime 1.6 Tech Note (≥█5 ) of 18 ╛ ╫# # ╫
d , Times
. +6,Macintosh Technical Notes . 4 .∙ ,
Courier í d ONLN d ! 'ä + Gpascal void SetTrackGWorld(Track theTrack, CGrafPtr port, GDHandle gdh, í d ONLN d H & ! 1 ╒ *
$TrackTransferProc proc, long refCon) í d ONLN d m : ! E I *theTrack í d ONLN d v : ä E )c The track to set the proc to. í d ONLN d ö D ! O 5 ( k ?port í d ONLN d Ö D ä O╪ )cDThe port for the track to draw to, or nil to use the Movie╒s GWorld. í d ONLN d ▐ N ! Y 0 ( u ?gdh í d ONLN d Γ N ä Y) )c!GDevice associated with the port. í d ONLN d X ! c 5 ( ?proc í d ONLN d X ä c─ )c@Returns pointer to your transfer procedure, or nil to remove it. í d ONLN dJ b ! m D ( ë ?refCon í d ONLN dR b ä mL )c(Value to pass to your tranfer procedure. í d ONLN d{ v ! üa ( ¥ ?@typedef pascal OSErr (*TrackTransferProc)(Track t, long refCon); í d ONLN d╝ î ! ÿ C *Errors í d ONLN d─ ÿ ! ú b * invalidMovie í d ONLN d╥ ÿ ä ú ¥ )c-2009 í d ONLN d╪ ÿ ¿ ú4 )$ Your track reference is bad. í d ONLN d⌡ « ! ║ Ä ( ╓ ?GetMovieCoverProcs ┘ = ┘∙ í d ONLN d ╝ ! ╟ { *GetMovieCoverProcs í d ONLN d ╗ { ╟e )Z5 lets you retrieve the cover procs that you set with í d ONLN dO ╝e ╟┐ )ΩSetMovieCoverProcs í d ONLN da ╗┐ ╟┬ )Z. í d ONLN dc ╤ ! ▄¼ ( ° ?Opascal OSErr GetMovieCoverProcs(Movie theMovie, MovieRgnCoverProc *uncoverProc, í d ONLN d│ █ ! µ ° *
+MovieRgnCoverProc *coverProc, long *refcon) í d ONLN d▀ ∩ ! · : *Movie í d ONLN dσ ∩ ä · ╘ )cMovie reference. í d ONLN d÷ ∙ ! v ( ?MovieRgnCoverProc í d ONLN d ∙ äG )c'Returns the uncover proc for the movie. í d ONLN d0 ! v (* ?MovieRgnCoverProc í d ONLN dB ä= )c%Returns the cover proc for the movie. í d ONLN dh ! 5 (4 ?long í d ONLN dm ä` )c,Returns the refcon for the cover procedures. í d ONLN dÜ# !/ C (K ?Errors í d ONLN dó/ !: b * invalidMovie í d ONLN d░/ ä: ¥ )c-2010 í d ONLN d╢/ ¿:4 )$ Your movie reference is bad. í d ONLN d╒Q _ δ ({ 6 Image Compression Enhancements ~ 4~∙ í d ONLN d⌠l x ╣ * The Image Compression has four í d ONLN dl ╣x┌ )í<new calls, and it's performance has been increased. Both the í d ONLN dPx äd (á 6?Photo CD and JPEG decompressors have been upgraded to directly í d ONLN dÅxdä┌ (áésupport the clipping of í d ONLN d¿ä É╝ (¼ 6]images. This greatly decreases the time necessary to display large images. In particular, it í d ONLN dä╝É┌ (¼┌makes í d ONLN d É £│ (╕ 6Rit much easier to work with high resolution Photo CD images. Now, we will discuss í d ONLN d]É│£┌ (╕╤the four í d ONLN df£ ¿ F (─ 6
new calls. í d ONLN dq┤ !└ ñ + SetSequenceProgressProc ▀ =▀∙ í d ONLN dë┬ !═ ö *SetSequenceProgressProc í d ONLN dá┴ ö═ σ )s allows you to í d ONLN d»┴ σ═┌ )Q,set a progress procedure on a Compression or í d ONLN d▄═ !┘R (⌡ ?;Decompression Sequence, just as in the past you could have í d ONLN d═R┘┌ (⌡pa progress procedure when í d ONLN d1┘ !σ ≥ ( ?+compressing or decompressing a still image. í d ONLN d^± !ⁿ¥ *Lpascal OSErr SetSequenceProgressProc(ImageSequence seqID, ProgressProcRecord í d ONLN d½√ ! g *
*progressProc) í d ONLN d║ ! : *seqID í d ONLN d└ ä Φ )cSequence identifier. í d ONLN d╒ !$ ] (@ ? progressProc í d ONLN dΓ ä$╬ )cBPointer to a record containing information about the application's í d ONLN d%# ä. ╩ *
progress proc. í d ONLN d49 E ╘ (a 6"The Image Compression Manager has í d ONLN dV9 ╘E┌ )╝53 additional calls which allow applications to zoom a í d ONLN dîE Q ⌐ (m 6 monitor. They are considered í d ONLN d⌐E ⌐Q? )æ low-level calls (comparable to í d ONLN d╚F?Qq )û
SetEntries í d ONLN d╥EqQ┌ )2) that should only be í d ONLN dΦQ ] (y 6+used when playing back QuickTime movies in í d ONLN dQ]┌ )°%a controlled environment with no user í d ONLN d9] i* (à 6>interaction. Also, because this capability is not present on í d ONLN dw]*i┌ (àH%all machines, applications should not í d ONLN d¥i u Å (æ 6depend on its availability. í d ONLN d╣ü ìN *BThe new calls provide a standard way for developers to access the í d ONLN d√üNì┌ (⌐lx mode of a user╒s monitor í d ONLN d ì Ö╕ (╡ 6Vfor playback. Effectively, this allows you to have full screen Compact Video playback í d ONLN d mì╕Ö┌ (╡╓on low í d ONLN d tÖ Ñ ò (┴ 6end Macintosh computers. ▀ 4▀∙
*16 ) of 18 (≥æQuickTime 1.6 Tech Note X ╫# # ╫
d , Times
. +6,Developer Technical Support ( ,╠
April 1993 . 4 .∙ í d ONLN d ( h ( D 6Hardware 200% í d ONLN d h (┌ )POresize is currently available only on the Macintosh LC II, IIvx, IIvi, Performa í d ONLN d ^ ( 4 ╠ ( P 6%400, Performa 600, and Color Classic í d ONLN d â ( ╠ 4╓ )┤6in 16-bit (thousands of colors) display mode on the 12 í d ONLN d ╣ (╓ 4┌ ( P⌠- í d ONLN d ║ 4 @╥ ( \ 6`inch (512 x 384 pixels) monitors. In the future, other graphic devices may take advantage of it. í d ONLN d L X s *To implement this í d ONLN d- L s X┌ )[Gfunctionality, the Image Compression Manager actually make calls to the í d ONLN du X d \ ( Ç 6Video Driver í d ONLN dé X \ d┌ )DLfor the given device. Video card manufacturers interested in supporting this í d ONLN d╧ d p ╬ ( î 6)functionality in their cards should link í d ONLN d° d ╬ p )╢
DEVSUPPORT í d ONLN d d pë )R for more information. í d ONLN d | ! ê b ( ñ ?
GDHasScale º = º∙ ,
Courier í d ONLN d$ è ! ò S *
GDHasScale í d ONLN d. ë S ò¢ )2J returns the closest possible scaling that a particular screen device can í d ONLN dx ë¢ ò┌ ( ▒╣be set to in a í d ONLN dç ò ! í_ ( ╜ ?Cgiven pixel depth. It returns scaling information for a particular í d ONLN d╩ ò_ í┌ ( ╜}GDevice for a requested í d ONLN dΓ í ! ¡ ▒ ( ╔ ? depth. It allows you to query í d ONLN d í ▒ ¡┌ )É;a GDevice without actually changing it. For example, if you í d ONLN d< ¡ ! ╣ F ( ╒ ?specify í d ONLN dD « F ╣ i )%0x20000 í d ONLN dK ¡ i ╣ ╜ )#, but the GDevice í d ONLN d] ¡ ╜ ╣ )Tdoes not support it, í d ONLN dr « ╣P )a
GDHasScale í d ONLN d| ¡P ╣í )2 will return with í d ONLN dÄ «í ╣║ )QnoErr í d ONLN dô ¡║ ╣┌ ), and a í d ONLN d¢ ╣ ! ┼ H ( ß ? scale of í d ONLN dñ ║ H ┼ k )'0x10000 í d ONLN d½ ╣ k ┼û )#?. Remember, it checks for a supported depth, so your requested í d ONLN dΩ ╣û ┼┌ ( ß┤depth must be í d ONLN d° ┼ ! ╤ ó ( φ ?supported by the GDevice. í d ONLN d ╞ ó ╤ ╘ )ü
GDHasScale í d ONLN d ┼ ╘ ╤7 )2 references the video í d ONLN d2 ┼7 ╤┌ )c"driver through the graphics device í d ONLN dU ╤ ! ▌ M ( ∙ ?
structure. í d ONLN d` Θ ! ⌡ 5 *For í d ONLN dd Θ 5 ⌡┌ )Vmultiple screens, see "Multiple Screen Revealed" in develop 10 to find out how to walk í d ONLN d╗ ⌡ ! p ( ?the GDeviceList. í d ONLN d╠ !W *>pascal OSErr GDHasScale(GDHandle gdh,short depth,Fixed *scale) í d ONLN d ! !, 0 *gdh í d ONLN d! ä,= )c%a handle to a screen graphics device. í d ONLN d6+ !6 : (R ?depth í d ONLN d<+ ä6╪ )cDpixel depth of screen device. Use this field to specify which pixel í d ONLN dü5 ä@â *
3depth that scaling information should returned for. í d ONLN d╡? !J : (f ?scale í d ONLN d╗? äJ╪ )cDa pointer to a fixed point scale value. On input, this field should í d ONLN d I äT║ *
>be set to the desired scale value. On output, this field will í d ONLN d?S ä^╪ *
Dcontain the closest scale available for the given depth. A scale of í d ONLN dä] äh╬ *
B0x10000 indicates normal size, 0x20000 indicates double size, etc. í d ONLN d╟s ! C (¢ ?Errors í d ONLN d╧ !è N * cDepthErr í d ONLN d┘ äè= )c%The requested depth is not supported. í d ONLN d ë !ö D (░ ?cDevErr í d ONLN dë äö Φ )cNot a screen device. í d ONLN d ô !₧ S (║ ?
controlErr í d ONLN d'ô ä₧V )c*Video driver can not respond to this call. í d ONLN dR⌐ !╡ ` (╤ ?
GDGetScale ╘ =╘∙ í d ONLN d]╖ !┬ S *
GDGetScale í d ONLN dg╢ S┬o )2? returns the current scale of the given screen graphics device. í d ONLN dº╠ !╫\ (≤ ??pascal OSErr GDGetScale(GDHandle gdh,Fixed *scale,short *flags) í d ONLN dτα !δ 0 *gdh í d ONLN dδα äδ= )c%a handle to a screen graphics device. í d ONLN dΩ !⌡ : ( ?scale í d ONLN dΩ ä⌡ù )c7pointer to a fixed point field to hold the scale result í d ONLN dO⌠ ! : ( ?flags í d ONLN dU⌠ ä ╬ )cBpointer to a short. It returns the status parameter flags for the í d ONLN dÿ■ ä ╡ *
=video driver. For now, zero is always returned in this field. í d ONLN d╓ ! C (< ?Errors í d ONLN d▐ !+ D * cDevErr í d ONLN dµ ä+ Φ )cNot a screen device. í d ONLN d√* !5 S (Q ?
controlErr í d ONLN d * ä5V )c*Video driver can not respond to this call. í d ONLN d 1L !X ^ (t ?
GDSetScale w =w∙ í d ONLN d <Y !e+ *8GDSetScale sets a screen graphics device to a new scale. í d ONLN d uo !zR *=pascal OSErr GDSetScale(GDHandle gdh,Fixed scale,short flags) í d ONLN d │â !Ä 0 *gdh í d ONLN d ╖â äÄ= )c%a handle to a screen graphics device. í d ONLN d ▌ì !ÿ : (┤ ?scale í d ONLN d πì äÿ )ca fixed point scale value. í d ONLN d ■ù !ó : (╛ ?flags í d ONLN d
ù äó ┘ )calways pass zero. ▀ 4▀∙
(≥ 6QuickTime 1.6 Tech Note (≥█7 ) of 18 b ╫# # ╫
d , Times
. +6,Macintosh Technical Notes . 4 .∙ í d ONLN d ! ( C + Errors ,
Courier í d ONLN d ( ! 3 D * cDevErr í d ONLN d ( ä 3 Φ )cNot a screen device. í d ONLN d % 2 ! = S ( Y ?
controlErr í d ONLN d 0 2 ä =V )c*Video driver can not respond to this call. í d ONLN d [ ` n ∩ ( è 6 Base Media Handler Enhancements ì 4 ì∙ í d ONLN d { { ç - *The í d ONLN d { - ç┌ )VBase Media Handler interface has been extended with 3 new calls, and a new flag. These í d ONLN d ╓ ç ô ≤ ( » 6,features were added to provide high quality í d ONLN d ç ≤ ô┌ )█,movie playback. The text media handler takes í d ONLN d/ ô ƒÇ ( ╗ 6Madvantage of these new calls, and provides built-in support for anti-aliased í d ONLN d| ôÇ ƒ┌ ( ╗₧text. It is achieved í d ONLN dæ ƒ ½ Æ ( ╟ 6through a playback hint í d ONLN d⌐ ƒ Æ ½┌ )z=to the base media handler, which the Apple Text Media Handler í d ONLN dτ ½ ╖ B ( ╙ 6
derives. í d ONLN d± ½ B ╖ s )* This hint, í d ONLN dⁿ ¼ s ╖ ├ )1hintsHighQuality í d ONLN d ½ ├ ╖┌ )P6, has been discussed in the Movie Toolbox Enhancements í d ONLN dC ╖ ├ Z ( ▀ 6section above. í d ONLN dR ╧ █ - *The í d ONLN dV ╨ - █ n )MediaSetHints í d ONLN dc ╧ n █ à )A and í d ONLN dh ╨ à █ )MediaGetOffscreenBufferSize í d ONLN dâ ╧ █┌ )ç) routines were added to the Derived Media í d ONLN d¡ █ τQ ( 6@Handler interface to support high quality mode. Since the Apple í d ONLN dφ █Q τ┌ (oText Media Handler derives í d ONLN d τ ≤ ( 6Pthe base media handler, it can use these new calls to support anti-aliased text. í d ONLN dY ! o + MediaSetHints - =-∙ í d ONLN dg ! E *When í d ONLN dl E Ü )$SetMoviePlayHints í d ONLN d} Ü ▓ )U or í d ONLN dü ▓ )SetMediaPlayHints í d ONLN dÆá )U is called by an application, í d ONLN d░á┌ )Ö
your media í d ONLN d╗ !' Q (C ?
handler╒s í d ONLN d┼ Q' Æ )0MediaSetHints í d ONLN d╥ Æ' ─ )A routine is í d ONLN d▐ ─'┌ )29called. This allows you to implement appropriate behavior í d ONLN d' !3m (O ?Efor the various media hints such as scrub mode and high quality mode. í d ONLN d^? !Jä *Gpascal ComponentResult MediaSetHints (ComponentInstance ci, long hints) í d ONLN dªU !` + *ci í d ONLN d⌐U ä`[ )c+Component instance of a base media handler. í d ONLN d╒_ !j : (å ?hints í d ONLN d█_ äjì )c5All hint bits the currently apply to the given media. í d ONLN du !ü C (¥ ?Errors í d ONLN dü !î à * badComponentInstance í d ONLN d.ü ¿î ┌ )ç
0x80008001 í d ONLN d9ü ≡î| )H Get a new component instance í d ONLN dVÜ !ª ╝ (┬ ?MediaGetOffscreenBufferSize ┼ =┼∙ í d ONLN dsº !│ *+Before the Base Media Handler allocates an í d ONLN d₧º│┌ )µ'offscreen buffer for your Derived Media í d ONLN d╞│ !┐ Ä (█ ?Handler, it calls your í d ONLN d▌┤ Ä┐ )mMediaGetOffscreenBufferSize í d ONLN d°│┐¿ )ç routine to allow your media í d ONLN d│¿┐┌ )ô
handler to í d ONLN d ┐ !╦ (τ ?2chose the dimensions of the buffer. The depth and í d ONLN dR┐╦┌ )∩,color table that will be used for the buffer í d ONLN d╦ !╫ π (≤ ?)are also passed. When you are called the í d ONLN d¿╠ π╫ )┬
rectBounds í d ONLN d▓╦╫å )2 parameter specifies the í d ONLN d╦╦å╫┌ )qsize that the Base í d ONLN d▐╫ !π ┬ ( ? Media Handler will use for your í d ONLN d■╫ ┬π┌ )í8offscreen by default. You can modify this as appropriate í d ONLN d7π !∩à ( ?Kbefore returning. This capability is useful if your media handler can only í d ONLN déπà∩┌ ( údraw at particular í d ONLN dò∩ !√ Ü ( ? sizes. It is also useful for í d ONLN d▓∩ Ü√┌ )yBimplementing anti-aliased drawing as you can request a buffer that í d ONLN d⌡√ ! J (# ?
is larger í d ONLN d √ J┌ ))Pthan your destination area, and have the Base Media Handler scale the image down í d ONLN dP ! G (/ ?for you. í d ONLN dZ !*º *Npascal ComponentResult MediaGetOffscreenBufferSize (ComponentInstance ci, Rect í d ONLN d⌐) !4 ≤ *
**rectBounds, short depth, CTabHandle ctab) í d ONLN d╘= !H + *ci í d ONLN d╫= äH[ )c+Component instance of a base media handler. í d ONLN d G !R : (n ?Rect í d ONLN d G äRQ )c)The boundaries of your off-screen buffer. í d ONLN d 3Q !\ : (x ?depth í d ONLN d 9Q ä\ ≈ )cDepth of the offscreen. í d ONLN d Q[ !f 5 (é ?ctab í d ONLN d V[ äf║ )c>Color table associated with off-screen. You can set it to nil. í d ONLN d òq !} C (Ö ?Errors í d ONLN d ¥} !ê à * badComponentInstance í d ONLN d ▓} ¿ê ┌ )ç
0x80008001 í d ONLN d ╜} ≡êü )H Get a new component instance. ▀ 4▀∙
(≥ 68 ) of 18 (≥æQuickTime 1.6 Tech Note ┌ ╫# # ╫
d , Times
. +6,Developer Technical Support ( ,╠
April 1993 . 4 .∙ í d ONLN d ! ( r ( D ? MediaGetName G = G∙ ,
Courier í d ONLN d * ! 5 ] * MediaGetName í d ONLN d ) ] 5ï )<= let's you retrieve the name of the media type. For example, í d ONLN d V )ï 5┌ ( Q⌐the video media í d ONLN d f 5 ! A ╥ ( ] ?'handler will return the string "Video". í d ONLN d Ä K ! V *Fpascal ComponentResult MediaGetName(MediaHandler mh, Str255 name, long í d ONLN d ╒ U ! ` ε *
)requestedLanguage, long *actualLanguage ) í d ONLN d i ! t v *ComponentInstance í d ONLN d i ä t$ )c The base media handler instance. í d ONLN d2 s ! ~ ? ( Ü ?Str255 í d ONLN d9 s ä ~ )cThe name of the media type. í d ONLN dU } ! ê 5 ( ñ ?Long í d ONLN dZ } ä ê ┘ )cA bunch of flags. í d ONLN dl ô ! ƒ C ( ╗ ?Errors í d ONLN dt ƒ ! ¬ à * badComponentInstance í d ONLN dë ƒ ¿ ¬ ┌ )ç
0x80008001 í d ONLN dö ƒ ≡ ¬ü )H Get a new component instance. í d ONLN d▓ ═ █ ∩ ( ≈ 6 Text Media Handler Enhancements · 4 ·∙ í d ONLN d╥ Φ ⌠╩ *]The text media handler interface includes 6 new flags, and one new routine. The flags let you í d ONLN d0 ⌠ ╩ * ^control the behavior of the text media handler. The display flags are used in conjunction with í d ONLN dÅ ) * the í d ONLN dô ) ` ) AddTESample í d ONLN d₧ ` w )7 and í d ONLN dú w ╕ )AddTextSample í d ONLN d░ ╕ î )A/ routines. The display flags are passed in the í d ONLN d▀î ╚ )╘ displayFlags í d ONLN d∞ I (4 6
parameter. í d ONLN d≈% 0 r *dfContinuousScroll í d ONLN d $ r0╢ )ZF is a display flag which tells the Apple Text Media Handler to let new í d ONLN dP0 < φ (X 6-samples cause previous samples to scroll out. í d ONLN d~G R O * dfFlowHoriz í d ONLN dëF OR╕ )7O is a display flag which tells the Apple Text Media Handler to let horizontally í d ONLN d┘R ^═ (z 6cscrolled text to flow within the text box. This behavior contrasts with letting text flow as if the í d ONLN d=^ j û * text box had no right edge. í d ONLN dYw é T * dfDropShadow í d ONLN dev Té╔ )<P is a display flag which tells the Apple Text Media Handler to support true drop í d ONLN d╢é Ä g (¬ 6shadows. Using í d ONLN d┼â gÄ ╝ )OSetTextSampleData í d ONLN d╓é ╝Ä╤ )U;, the position and translucency of the drop shadow is under í d ONLN dÄ Ü r (╢ 6application control. í d ONLN d'Ñ ░ O * dfAntiAlias í d ONLN d2ñ O░╓ )7V is a display flag which tells the Apple Text Media handler to attempt to display text í d ONLN dë░ ╝ P (╪ 6anti-aliased. í d ONLN dù╔ ╘ O * dfKeyedText í d ONLN dó╚ O╘╔ )7S is a display flag which tells the Apple Text Media handler to render text over the í d ONLN d÷╘ α╝ (ⁿ 6Ubackground without drawing the background color. This technique is otherwise known as í d ONLN dLα ∞ c * "Masked Text." í d ONLN d[° 6 *enum { í d ONLN db w *
dfContinuousScroll í d ONLN dv ä º )l= 1<<9, í d ONLN d T (3 6 dfFlowHoriz í d ONLN dì ä ¼ )l= 1<<10, í d ONLN dû ! Y (= 6dfDropShadow í d ONLN dÑ ä! ¼ )l= 1<<12, í d ONLN d» + T (G 6 dfAntiAlias í d ONLN d╜ ä+ ¼ )l= 1<<13, í d ONLN d╟* 5 T (Q 6 dfKeyedText í d ONLN d╒* ä5 º )l= 1<<14 í d ONLN d▌4 ? " ([ 6}; í d ONLN dαK V m *findTextUseOffset í d ONLN d±J mV4 )U) is a new find text flag which instructs í d ONLN dK4Vp )╟ FindNextText í d ONLN d&JpV┌ )< to look at the value í d ONLN d<V b r (~ 6pointed to by the í d ONLN dNV rb┌ )ZIoffset parameter and start the search at that offset into the text sample í d ONLN dÿb n T (è 6indicated by í d ONLN dÑc Tn ü )< startTime í d ONLN d«b ünï )-:. This allows you to continue a text search from within a í d ONLN dΦbïn┌ (è⌐given sample, so í d ONLN d∙n zÿ (û 6Sthat multiple occurrences of the search string can be found within a single sample. ▀ 4▀∙
*\QuickTime 1.6 Tech Note (≥█9 ) of 18 X ╫# # ╫
d , Times
. +6,Macintosh Technical Notes . 4 .∙ ,
Courier í d ONLN d & 1 ï *!findTextUseOffset = 16; í d ONLN d < ! H ê + SetTextSampleData g = g∙ í d ONLN d + J ! U v *SetTextSampleData í d ONLN d < I v U )U# allows you to set values prior to í d ONLN d _ I U4 )¢calling í d ONLN d g J4 Uu )#AddTextSample í d ONLN d t Iu Uç )A or í d ONLN d x Jç U╛ ) AddTESample í d ONLN d â I╛ U┌ )7. Two í d ONLN d ë U ! aV ( } ?Btypes are currently supported: 'drpo' and 'drpt'. The first type, í d ONLN d ╦ UV a┌ ( }t'drpo', is the drop shadow í d ONLN d µ a ! m ƒ ( ë ?offset. Pass the address í d ONLN d a ƒ m┌ )~<of a point for the data parameter. 'drpt' is the drop shadow í d ONLN d< m ! y╖ ( ò ?Ytranslucency. Pass a value from 0 to 255, where 0 is the lightest and 256 is the darkest. í d ONLN dû â ! Ä╧ *Vpascal ComponentResult SetTextSampleData(MediaHandler mh, void *data, OSType dataType) í d ONLN dφ ù ! ó + *mh í d ONLN d≡ ù ä ó┐ )c?Reference to the text media handler. Could use GetMediaHandler. í d ONLN d0 í ! ¼ 5 ( ╚ ?data í d ONLN d5 í ä ¼o )c/Pointer to data, defined by dataType parameter. í d ONLN df ½ ! ╢ S ( ╥ ?
handleType í d ONLN dq ½ ä ╢║ )c>Sets the type of data in the handle. For now, either 'drpo' or í d ONLN d░ ╡ ä └ º *
'drpt'. í d ONLN d╕ ╦ ! ╫ C ( ≤ ?Errors í d ONLN d└ ╫ ! Γ à * badComponentInstance í d ONLN d╒ ╫ ¿ Γ ┌ )ç
0x80008001 í d ONLN dα ╫ ≡ Γ« )H&Your media handler reference is hosed. í d ONLN d δ ! ≈. ( ?7Here is some sample pseudo-code (it might not compile): í d ONLN d? ! ? *short í d ONLN dF ` £ )? trans = 127; í d ONLN dS ! : (2 ?Point í d ONLN dY ` ù )? dropOffset; í d ONLN de !* ┴ (F ? dropOffset.h = dropOffset.v = 4; í d ONLN då) !4 *
-SetSampleData(mh,(void *)&dropOffset,'drpo'); í d ONLN d┤3 !> Θ *
(SetSampleData(mh,(void *)&trans,'drpt'); í d ONLN d▌I !U è *Be sure to turn on the í d ONLN d⌠J èU ╞ )i dfDropShadow í d ONLN d I ╞UG )< display flag when you call í d ONLN d KGTä )üAddTextSample í d ONLN d)IäUö )= or í d ONLN d-JöU╦ ) AddTESample í d ONLN d8I╦U╬ )7. í d ONLN d:m { (ù 6$Import/Export Component Enhancements Ü 4Ü∙ í d ONLN d_ê öò *GExport components have one new flag, one new error, two new functions, í d ONLN dªêòö┌ (░│ one new data í d ONLN d│ö á ⌐ (╝ 6 structure, one new component, í d ONLN d╤ö ⌐á┌ )æ:and an enhancement to the Sound Export component. The Text í d ONLN d á ¼ ö (╚ 6Movie export component í d ONLN d#á ö¼┌ )|>was introduced above. Import components have one new function. í d ONLN db¼ ╕K (╘ 6;The Audio CD Movie Import component was already introduced. í d ONLN d₧┼ ╨ ƒ *canMovieExportAuxDataHandle í d ONLN d╣─ ƒ╨ ╪ )ç is a movie í d ONLN d┼─ ╪╨┌ )9/export component flag. A Movie Export Component í d ONLN d⌡╨ ▄ è (° 6that supports the í d ONLN d╤ è▄ )rMovieExportGetAuxiliaryData í d ONLN d"╨▄k )ç call should í d ONLN d/╨k▄┌ )Zalso now set the í d ONLN d@▌ Φ ƒ ( 6canMovieExportAuxDataHandle í d ONLN d[▄ ƒΦ ╤ )ç flag in its í d ONLN dh▌ ╤Φ )2ComponentFlags í d ONLN dv▄Φ )F. í d ONLN dy⌠ < ß ( Z!canMovieExportAuxDataHandle = 128 í d ONLN d¢
K (2 6
The error í d ONLN dÑ K ß )3 auxiliaryExportDataUnavailable í d ONLN d├
ß µ )û í d ONLN d─
µ┌ ).has been added. It will be returned by a Movie í d ONLN d≤ " ö (> 6Export Component when í d ONLN d ö" )|MovieExportGetAuxiliaryData í d ONLN d$" )ç is called requesting í d ONLN d:"┌ )da type of auxiliary í d ONLN dN" . ╓ (J 6(data that the component cannot generate. í d ONLN dy: <E · +$&auxiliaryExportDataUnavailable = -2058 í d ONLN dáP \ π (x 6%The Sound Movie Export component has í d ONLN d┼P π\┌ )╦/been updated to take advantage of the new Sound í d ONLN d⌡\ h (ä 6Manager. Previously, í d ONLN d
\ h┌ )gFonly the first sound track in the movie was exported. Now sound tracks í d ONLN dQh t ± (É 6-are mixed together before being exported. If í d ONLN d~h ±t┌ )┘/your application wants to take advantage of the í d ONLN d«t Ç ¿ (£ 6sound mixing, you can use í d ONLN d╚u ¿Ç )ÉPutMovieIntoTypedHandle í d ONLN d▀tÇa )s. It will take í d ONLN dεtaÇ┌ )Fadvantage of the export í d ONLN d Ç îQ (¿ 6>component. Furthermore, you can now specify the format of the í d ONLN d DÇQî┌ (¿oexported sound, so you can í d ONLN d _î ÿ9 (┤ 6>convert 16 bit sound to 8 bit sound, or reduce stereo to mono. ▀ 4▀∙
*>10 )
of 18 (≥æQuickTime 1.6 Tech Note ° ╫# # ╫
d , Times
. +6,Developer Technical Support ( ,╠
April 1993 . 4 .∙ í d ONLN d ! ( ┘ ( D ? MovieExportSetSampleDescription G = G∙ ,
Courier í d ONLN d 4 ! ? ╝ * MovieExportSetSampleDescription í d ONLN d ? 3 ╝ ?₧ )¢0 allows an application to request the format of í d ONLN d o 3₧ ?┌ )Γ the exported í d ONLN d | ? ! K w ( g ?data, the routine í d ONLN d Ä @ w K )V MovieExportSetSampleDescription í d ONLN d ¡ ? Kè )¢ has been added. This í d ONLN d ├ ?è K┌ )xcall is currently í d ONLN d ╒ K ! W ( s ?.supported by the Movie Export Sound Component. í d ONLN d a ! l▒ *Ppascal ComponentResult MovieExportSetSampleDescription(MovieImportComponent ci, í d ONLN dU k < v' +
/SampleDescriptionHandle desc, OSType mediaType) í d ONLN dà ! è + ( ª ?ci í d ONLN dê ä èe )c-Component Instance of movie import component. í d ONLN d╢ ë ! ö 5 ( ░ ?desc í d ONLN d╗ ë ä öo )c/Handle to a valid QuickTime sample description. í d ONLN dδ ô ! ₧ N ( ║ ? mediaType í d ONLN d⌡ ô ä ₧ª )c:The type of the media that the sample description is from. í d ONLN d0 ⌐ ! ╡ C ( ╤ ?Errors í d ONLN d8 ╡ ! └ à * badComponentInstance í d ONLN dM ╡ ¿ └ ┌ )ç
0x80008001 í d ONLN dX ╡ ≡ └ü )H Get a new component instance. í d ONLN dv ╔ ! ╒ ▌ ( ± ? MovieImportGetAuxiliaryDataType ⌠ = ⌠∙ í d ONLN dû ╫ ! Γ ╝ * MovieImportGetAuxiliaryDataType í d ONLN d╡ ╓ ╝ Γª )¢6 should return the type of the auxiliary data that it í d ONLN dδ ╓ª Γ┌ )Ω can accept. í d ONLN d≈ Γ ! ε ö (
?This is useful if you are í d ONLN d Γ ö ε┌ )sDinterested with import components directly. For example, if you call í d ONLN dV ε ! ·┼ ( ?athe text import component with this call, it will indicate that it can accept 'styl' information. í d ONLN d╕ !╢ *Qpascal ComponentResult MovieImportGetAuxiliaryDataType(MovieImportComponent ci, í d ONLN d
< î +
OSType *auxType) í d ONLN d" !- + (I ?ci í d ONLN d " ä-ì )c5The movie import component instance. Retrieve it with í d ONLN dT, ä7B *
&OpenDefaultComponent or OpenComponent. í d ONLN d{6 !A D (] ?auxType í d ONLN dâ6 äA ≈ )cPointer to the type of í d ONLN dÜ6 ≈A┌ )s,auxiliary data it can import. For example, a í d ONLN d╟@ äK╨ (g ó@text import component can bring in 'text' data. But, if it says í d ONLN d@╨K┌ (gεit í d ONLN d
J äU Θ (q ócan return 'styl', í d ONLN d J ΘU┌ )e,then it will import the style information as í d ONLN dJT ä_ ¥ ({ ówell. í d ONLN dPj !v C (Æ ?Errors í d ONLN dXv !ü à * badComponentInstance í d ONLN dmv ¿ü ┌ )ç
0x80008001 í d ONLN dxv ≡ü╤ )H-Your movie import component reference is bad. í d ONLN dªî ÿ ⌠ (┤ 61Here is a new data structure for the text export í d ONLN d╫î ⌠ÿ┌ )▄1component. This data is useful after a text track í d ONLN d ÿ ñ├ (└ 6Zhas been exported. An application may want to know the way the text was stored as a track. í d ONLN dd░ !╗ q + typedef struct { í d ONLN dv║ <┼ P +
long í d ONLN d|║ ä┼ ┼ )HdisplayFlags; í d ONLN dï─ <╧ P (δ Zlong í d ONLN dæ─ ä╧ ▐ )HtextJustification; í d ONLN dÑ╬ <┘ d (⌡ ZRGBColor í d ONLN d«╬ ä┘ ¼ )HbgColor; í d ONLN d╕╪ <π P ( ZRect í d ONLN d╛╪ äπ ¼ )HtextBox; í d ONLN d╚Γ <φ U ( Zshort í d ONLN d╧Γ äφ └ )H beginHilite; í d ONLN d▌∞ <≈ U ( Zshort í d ONLN dΣ∞ ä≈ ╢ )H
endHilite; í d ONLN d≡÷ < d ( ZRGBColor í d ONLN d∙÷ ä └ )H hiliteColor; í d ONLN d < _ (' ZBoolean í d ONLN d ä ╩ )HdoHiliteColor; í d ONLN d
< i (1 Z TimeValue í d ONLN d)
ä ╧ )HscrollDelayDur; í d ONLN d: < U (; ZPoint í d ONLN dA ä ┘ )HdropShadowOffset; í d ONLN dT <) U (E Zshort í d ONLN d[ ä) ≈ )HdropShadowTransparency; í d ONLN ds( !3 { (O ?} TextDisplayData; ▀ 4▀∙
(≥ 6QuickTime 1.6 Tech Note (≥╓11 )
of 18 ε ╫# # ╫
d , Times
. +6,Macintosh Technical Notes . 4 .∙ í d ONLN d ! ( ░ + TextExportGetDisplayData G = G∙ ,
Courier í d ONLN d * ! 5 Ö *TextExportGetDisplayData í d ONLN d 1 ) Ö 5q )x, returns the text display data for the text í d ONLN d ] )q 5┌ )╪sample that was last í d ONLN d r 5 ! Aq ( ] ?Gexported by the given text export component. After exporting text from í d ONLN d ╣ 5q A┌ ( ]Åa text track, it is often í d ONLN d ╙ A ! M; ( i ?>useful to find out about the text track characteristics. This í d ONLN d A; M┌ ( iY"data structure contains this extra í d ONLN d4 M ! Y [ ( u ? information. í d ONLN dA c ! nÄ *Ipascal ComponentResult TextExportGetDisplayData(TextExportComponent ci, í d ONLN dï m < x ¬ +
TextDisplayData *data) í d ONLN dó ü ! î + ( ¿ ?ci í d ONLN dÑ ü ä îê )c4The text export component instance. Retrieve it with í d ONLN d┌ ï ä ûB *
&OpenDefaultComponent or OpenComponent. í d ONLN d ò ! á X ( ╝ ? displayData í d ONLN d ò ä á) )c!Pointer to the text display data. í d ONLN d/ ½ ! ╖ C ( ╙ ?Errors í d ONLN d7 ╖ ! ┬ à * badComponentInstance í d ONLN dL ╖ ¿ ┬ ┌ )ç
0x80008001 í d ONLN dW ╖ ≡ ┬╤ )H-Your movie import component reference is bad. í d ONLN dà ┘ τ W ( 6 ColorSync 4∙ í d ONLN dÅ ⌠ ₧ *RColorSync is an extension for Macintosh providing a platform for consistent color í d ONLN dß ⌠₧ ┌ ( ╝ reproduction í d ONLN dε ╢ (( 6 between widely varying output í d ONLN d ╢ ┌ )₧6devices. Color Matching ability was added to the Image í d ONLN dC ç (4 6Compression Manager í d ONLN dW ç ╛ )o DrawPicture í d ONLN db ╛⌐ )73 calls. Accurate color reproduction of images (not í d ONLN dò ⌐┌ )δ
movies) is í d ONLN dá $ ╤ (@ 6&made easier with QuickTime╒s flexible í d ONLN d╞ ╤$ )╣ DrawPicture í d ONLN d╤$u )7 calls. To enable color í d ONLN dΩu$┌ )mmatching you simply í d ONLN d■$ 0 ; (L 6set the í d ONLN d% ;0 ï )#useColorMatching í d ONLN d$ ï0 ▓ )P flag in í d ONLN d $ ▓0┌ )'=the flags parameter to these calls. You can set the flag even í d ONLN d]0 <1 (X 6=when ColorSync is not installed, although it will be ignored. í d ONLN d£H <S á +$useColorMatching = 4 í d ONLN d▒j x ▀ (ö 6 Sequence Grabber Enhancement ù 4ù∙ í d ONLN d╬à æ σ *(The Sequence Grabber component has just í d ONLN d÷à σæJ )═one flag added to it. í d ONLN d åJæ« )egrabPictCurrentImage í d ONLN d à«æ┌ )d is a new í d ONLN d*æ ¥ M (╣ 6 flag to the í d ONLN d6Æ M¥ )5
SGGrabPict í d ONLN d@æ ¥ Ñ )2
call. It í d ONLN dJæ Ñ¥┌ )&?provides the fastest possible image capture, but may fail under í d ONLN dè¥ ⌐ ≥ (┼ 62certain circumstances. This failure is not fatal; í d ONLN d╝¥ ≥⌐┌ )┌3it just will not return a picture. The routine does í d ONLN d≡⌐ ╡ (╤ 66not pause the current preview or grab the next frame. í d ONLN d&⌐╡┌ )·*It causes the currently displayed image to í d ONLN dQ╡ ┴ ┴ (▌ 6'be captured. It is a good idea to call í d ONLN dx╢ ┴┴ Σ )⌐SGPause í d ONLN d╡ Σ┴T )# yourself before calling í d ONLN dÿ╢T┴å )p
SGGrabPict í d ONLN dó╡å┴╔ )2 with this flag. í d ONLN d┤═ <╪ ┤ (⌠ ZgrabPictCurrentImage = 4 í d ONLN d═∩ ² ╜ ( 6Image Codec Enhancement 4 ∙ í d ONLN dσ
c *;The interface for image codecs has three new functions and í d ONLN d
c┌ (2üone new flag defined. í d ONLN d6 " ò (> 6codecConditionFirstScreen í d ONLN dO ò"£ )}9 is a new codec condition flag to the ImageCodec.h file. í d ONLN dè, <7 ß (S Z!#define codecConditionFirstScreen í d ONLN d¼, ≡7 )┤(1L<<12) í d ONLN d╡B N╨ (j 6UThe Standard Compression Dialog now provides Compressor Components with the option of í d ONLN d N Z¡ * Xdisplaying their own settings within the dialog. If a compressor supports the dialog, an í d ONLN ddZ f╓ * ^additional button will appear. The compressors settings are saved with the standard compressor í d ONLN d├f r l * settings when the
í d ONLN d╒f lr ó )T SCGetInfo í d ONLN d▐f ór )6 call is used with the
í d ONLN d⌡frv )bscCodecSettingsType í d ONLN d fvr╘ )r flag. The codec can í d ONLN d r ~< (Ü 6?implement the functionality using the following three routines. ▀ 4▀∙
*X12 )
of 18 (≥æQuickTime 1.6 Tech Note ┌ ╫# # ╫
d , Times
. +6,Developer Technical Support ( ,╠
April 1993 . 4 .∙ í d ONLN d ( ! 4 ç ( P ?CDRequestSettings S = S∙ ,
Courier í d ONLN d @ ! K v *CDRequestSettings í d ONLN d # ? v K⌐ )UC allows the display of a dialog of additional compression settings í d ONLN d f ?⌐ K┌ ( g╟ specific to í d ONLN d r K ! W Ñ ( s ? the codec. This information í d ONLN d Ä K Ñ W┌ )äAis stored in a settings handle. The codec can store whatever data í d ONLN d ╨ W ! c⌐ ( ?Win any format wants in the settings handle and resize it accordingly. It should store í d ONLN d' W⌐ c┌ ( ╟ some type í d ONLN d1 c ! o ( ï ?5of tag/version information that it can use to verify í d ONLN df c o┌ )≤(that the data belongs to the codec. The í d ONLN dÅ o ! { ╪ ( ù ?$codec should NOT dispose the handle. í d ONLN d┤ à ! É╩ *Upascal ComponentResult CDRequestSettings(ComponentInstance ci, Handle settings, Rect í d ONLN d
Å ! Ü ╨ *
#*rp, ModalFilterProcPtr filterProc) í d ONLN d. ú ! « + *ci í d ONLN d1 ú ä « )c Component instance of codec. í d ONLN dN ¡ ! ╕ I ( ╘ ?settings í d ONLN dW ¡ ä ╕╬ )cBHandle of data specific to the codec. If the handle is empty, the í d ONLN dÜ ╖ ä ┬o *
/codec should use some type of default settings. í d ONLN d╠ ┴ ! ╠ + ( Φ ?rp í d ONLN d╧ ┴ ä ╠ ▒ )cPointer í d ONLN d╫ ┴ ▒ ╠┌ )-3to rectangle giving the coordinates of the Standard í d ONLN d ╦ ä ╓í ( ≥ ó9Compression dialog in screen coordinates. The codec can í d ONLN dD ╦í ╓┌ ( ≥┐ use this to í d ONLN dP ╒ ä αâ ( ⁿ ó3position its dialog in the same area of the screen. í d ONLN dä ▀ ! Ω S ( ?
filterProc í d ONLN dÅ ▀ ä Ω╝ )c:A pointer to modal dialog filter proc that the codec must í d ONLN d╔ ▀╝ Ω┌ (┌either í d ONLN d╨ Θ ä ⌠Æ ( ó4pass to ModalDialog or call at the beginning of the í d ONLN d ΘÆ ⌠┌ (░codec dialog's í d ONLN d ≤ ä ■Ö ( ó1filter. This proc gives the calling application í d ONLN dD ≤Ö ■┌ (╖ and Standard í d ONLN dQ ² äj ($ ó.Compression a chance to process update events. í d ONLN dÇ ! o (9 ?CDGetSettings < =<∙ í d ONLN dÄ) !4 b *CDGetSettings í d ONLN d¢( b4ò )A@ allows a codec to get the settings chosen by a user. From this í d ONLN d█(ò4┌ (P│call, the codec í d ONLN dδ4 !@ D (\ ?should í d ONLN d≥4 D@┌ )#[return its current internal settings. If there are no current settings or the settings are í d ONLN dN@ !LF (h ?@the same as the defaults, the codec can set the handle to empty. í d ONLN dÅb !m¥ *!Lpascal ComponentResult CDGetSettings(ComponentInstance ci, Handle settings) í d ONLN d▄v !ü + *ci í d ONLN d▀v äü )c Component instance of codec. í d ONLN dⁿÇ !ï I (º ?settings í d ONLN dÇ äï╬ )cBA handle that the codec should resize and fill in with the current í d ONLN dHè äò╔ *
Ainternal settings. It should be resized to empty if there are no í d ONLN dèö äƒ *
current internal settings. í d ONLN dѬ !╢ m (╥ ?CDSetSettings ╒ =╒∙ í d ONLN d│┬ !═ b *CDSetSettings í d ONLN d└┴ b═ ╚ )A allows a codec to set í d ONLN d╫┴ ╚═┌ )f;the settings of the optional dialog. Set the codecs current í d ONLN d═ !┘─ (⌡ ?Zinternal settings to the state specified in the settings handle. The codec should always í d ONLN dm═─┘┌ (⌡Γdo a í d ONLN dr┘ !σƒ ( ?Uvalidity check on the contents of the handle so that invalid settings are never used. í d ONLN d╚∩ !·¥ *Lpascal ComponentResult CDSetSettings(ComponentInstance ci, Handle settings) í d ONLN d ! + *ci í d ONLN d äe )c-Component Instance of movie import component. í d ONLN dF ! I (4 ?settings í d ONLN dO ä╡ )c=A handle to internal settings original returned by either the í d ONLN dì ä"╪ *
DCDRequestSettings or CDGetSettings calls. The codec should set it's í d ONLN d╥! ä,╔ *
Ainternal settings to match those of the settings handle. Because í d ONLN d + ä6╙ *
Cthe codec does not own the handle, it should not dispose of it, and í d ONLN d X5 ä@╡ *
=should only copy its contents, not the handle itself. If the í d ONLN d û? äJ░ *
<settings handle passed in is empty, the codec should set its í d ONLN d ╙I äT= *
%internal settings to a default state. ▀ 4▀∙
(≥ 6QuickTime 1.6 Tech Note (≥╓13 )
of 18 £ ╫# # ╫
d , Times
. +6,Macintosh Technical Notes . 4 .∙ í d ONLN d ( :, *) New Component Manager Features Y 4 Y∙ í d ONLN d H T╒ *YThe Component Manager in QuickTime 1.6 has some new features. The result returned for the í d ONLN d y T ` A *
selector, ,
Courier í d ONLN d â U A ` á ))gestaltComponentMgr í d ONLN d û T á `¡ )_9, will be 3, indicating version number 3 of the Component í d ONLN d ╨ ` l┘ ( ê 6bManager. It has added the ability to automatically resolve conflicts between different versions of í d ONLN d3 l x╠ * \the same Component. It will ensure that only the most recent version of a given component is í d ONLN dÉ x ä┤ * Vactually registered. In addition, the Component Manager now supports Icon Suites for a í d ONLN dτ ä Éé * JComponent, so a Component╒s icon no longer has to be just black and white. í d ONLN d3 ₧ ¬ 0 *The í d ONLN d7 ƒ 0 ¬ à )ComponentResource í d ONLN dH ₧ à ¬æ )U4 data structure can now have an optional extension. í d ONLN d| ₧æ ¬┌ ( ╞»This extension í d ONLN dï ¬ ╢╢ ( ╥ 6Vdefines additional information about the Component. The data structure is shown below. í d ONLN dΓ ┴ ╠ ╟ *#struct ComponentResourceExtension { í d ONLN d ╦ < ╓ P +$
long í d ONLN d ╦ ` ╓ ╡ )$componentVersion; í d ONLN d ╦ ≡ ╓r )É/* version of Component */ í d ONLN d; ╒ < α P ( ⁿ Zlong í d ONLN d@ ╒ ` α ╙ )$componentRegisterFlags; í d ONLN dX ╒ ≡ α| )É /* flags for registration */ í d ONLN dv ▀ < Ω U ( Zshort í d ONLN d| ▀ ` Ω ┐ )$componentIconSuite; í d ONLN dæ ▀ ≡ Ωï )É /* resource id of Icon Suite */ í d ONLN d▒ Θ ⌠ " ( 6}; í d ONLN d┤ ≤ ■q *
Etypedef struct ComponentResourceExtension ComponentResourceExtension; í d ONLN d· 2 *The í d ONLN d■ 2 ┤ )ComponentResourceExtension í d ONLN d ┤ )é is appended í d ONLN d%à )Mto the end of existing í d ONLN d< à┌ )äComponentResource í d ONLN dN (< 63structures. The Component Manager determines if it í d ONLN dü ┌ (<6'is present by examining the size of the í d ONLN d⌐ , C (H 6 resource. í d ONLN d│8 D / *The í d ONLN d╖9 /D )componentVersion í d ONLN d╟8 D- )P# field contains the version number í d ONLN dΩ8-D┌ )« of the component. This should be í d ONLN d D P │ (l 6#identical to the value returned by í d ONLN d.E │P )¢GetComponentVersion í d ONLN dADP )_. í d ONLN dCDP┌ )+For convenience, if this value is set to 0, í d ONLN doP \\ (x 6Bthe component is called to get the version. This is useful during í d ONLN d▒P\\┌ (xzdevelopment. The version í d ONLN d╩\ h k (ä 6number stored in í d ONLN d█\ kh } )Sthe í d ONLN d▀] }h )ComponentResourceExtension í d ONLN d∙\ h┌ )é* is used by the Component Manager to avoid í d ONLN d$h t┐ (É 6Yhaving to load and call the Component to retrieve the Component╒s version during startup. í d ONLN d~Ç î - *The í d ONLN déü -î ¢ )componentRegisterFlags í d ONLN dÿÇ ¢î, )n allow you to define additional í d ONLN d╕Ç,î┌ )æ%register information. These flags are í d ONLN d▐î ÿ Y (┤ 6 shown below. í d ONLN d∞ú « ╤ *%// Component Resource Extension flags í d ONLN d¡ ╕ 6 *
enum { í d ONLN d╖ <┬ ╥ +$
componentDoAutoVersion = 1<<0, í d ONLN d:┴ <╠ ▄ *
componentWantsUnregister = 1<<1, í d ONLN d\╦ <╓ *
'componentAutoVersionIncludeFlags = 1<<2 í d ONLN dä╒ α " (ⁿ 6}; í d ONLN dçΩ ÷ 0 *The í d ONLN dïδ 0÷ ₧ )componentDoAutoVersion í d ONLN díΩ ₧÷ ╝ )n flag í d ONLN dºΩ ╝÷┌ ) 3tells the Component Manager that you only want your í d ONLN d█÷ @ ( 6@Component registered if there is no later version available. If í d ONLN d÷@┌ ( ^ there is an older version of the í d ONLN d< ä (* 6IComponent installed, it will be unregistered. If an older version of the í d ONLN dàä┌ (*ósame Component í d ONLN dö └ (6 6(attempts to register after you, it will í d ONLN d╝ └┌ )¿;be immediately unregistered. Further, if a newer version of í d ONLN d° & (B 61the same Component registers after you, you will í d ONLN d )&┌ )∙(automatically be unregistered. Using the í d ONLN d R& 2{ (N 6Iautomatic version control feature of the Component Manager allows you to í d ONLN d ¢&{2┌ (NÖmake sure that only í d ONLN d »2 > E (Z 6 the most í d ONLN d ╕2 E>┌ )-Precent version of your software is running on a given machine, regardless of how í d ONLN d
> J ┤ (f 6 many versions many be installed. í d ONLN d
*V b - *The í d ONLN d
.W -b Ñ )componentWantsUnregister í d ONLN d
FV Ñb )x flag indicates that your í d ONLN d
`Vb┌ )q'Component wants to be called when it is í d ONLN d
êb n r (è 6unregistered. This í d ONLN d
¢b rn┌ )ZIis useful if your component allocates global memory at register time, for í d ONLN d
σn z─ (û 6Zexample. The prototype of the unregister message is identical to the register message. If í d ONLN d ?n─z┌ (ûΓyour í d ONLN d Dz å Q (ó 6
component í d ONLN d Nz Qå┌ )9Mhas never been opened, its unregister message will not be called. The routine í d ONLN d £å Æ ╚ (« 6'selector for unregister is given below. ▀ 4▀∙
*D14 )
of 18 (≥æQuickTime 1.6 Tech Note ╚ ╫# # ╫
d , Times
. +6,Developer Technical Support ( ,╠
April 1993 . 4 .∙ í d ONLN d ( - ( D 6The ,
Courier í d ONLN d - ( ═ ) componentAutoVersionIncludeFlags í d ONLN d $ ═ (s )á" flag tells the Component Manager í d ONLN d F s (┌ )ªto use the component í d ONLN d [ ( 4 b ( P 6flags as criteria í d ONLN d m ( b 4┌ )JNfor it's component search. If a component wants automatic version control, the í d ONLN d ╝ 4 @u ( \ 6FComponent Manager has to search for similar components. Normally, the í d ONLN d 4u @┌ ( \ôComponent Manager í d ONLN d @ L ] ( h 6only searches í d ONLN d" @ ] L┌ )EKfor another component using the type, subType, and manufacturer fields of a í d ONLN dn M X | ( t 6ComponentDescription í d ONLN dé L | Xá )d2 record. This flag tells the Component Manager to í d ONLN d┤ Lá X┌ ( t╛ include the í d ONLN d└ Y d ^ ( Ç 6componentFlags í d ONLN d╬ X ^ d £ )F in its search. í d ONLN d▐ p { ╟ ( ù 6##define kComponentUnregisterSelect í d ONLN d p ╠ { █ )┤ -7 í d ONLN d à æ O ( ¡ 6Finally, the í d ONLN d å O æ ⌐ )7componentIconSuite í d ONLN d& à ⌐ æ┌ )Z? field allows you to provide the resource id of a System 7 Icon í d ONLN df æ ¥0 ( ╣ 6DSuite. If this field is 0, it indicates that there is no icon suite. í d ONLN d¼ ╡ ! ┴ í + $GetComponentIconSuite α = α∙ í d ONLN d┬ ├ ! ╬ è *GetComponentIconSuite í d ONLN d╫ ┬ è ╬ú )i: returns an Icon Suite for the given Component. This call í d ONLN d ┬ú ╬┌ ( Ω┴
only works í d ONLN d ╬ ! ┌¥ ( ÷ ?Son System 7 or later. If called on System 6, it returns an error. If the Component í d ONLN do ╬¥ ┌┌ ( ÷╗ doesn╒t have í d ONLN d| ┌ ! µ 3 ( ?an í d ONLN d ┌ 3 µä ):Icon Suite but does have a Component Icon (as returned by í d ONLN d╣ █ä µ╘ (óGetComponentInfo í d ONLN d╔ ┌╘ µ┌ )P), í d ONLN d╠ τ ! ≥ è ( ?GetComponentIconSuite í d ONLN dß µ è ≥o )i1 creates an Icon Suite containing just the black í d ONLN d µo ≥┌ )σand white Component í d ONLN d& ≥ ! ■ ╛ ( ? Icon. In this way, you can use í d ONLN dE ≤ ╛ ■' )¥GetComponentIconSuite í d ONLN dZ ≥' ■à )i without regard to í d ONLN dm ≥à ■┌ )^whether or not a í d ONLN d~ ■ !
M (& ?<Component has an Icon Suite or just simply a Component Icon. í d ONLN d╗ !"r *BFor more details on Icon Suites, see the Tech Note on Icon Suites í d ONLN d²r"┌ (>É(M.IM.IconDrawing), í d ONLN d" !. ╬ (J ?!"Drawing Icons the System 7 Way". í d ONLN d3: !Eÿ *Kpascal OSErr GetComponentIconSuite(Component aComponent, Handle *iconSuite) í d ONLN dP ![ S *
aComponent í d ONLN dèP ä[o )c/Component id, retrieved with FindNextComponent. í d ONLN d║Z !e N (ü ? iconSuite í d ONLN d─Z äe[ )c+Pointer to the icon suite you will receive. í d ONLN d≡p !| C (ÿ ?Errors í d ONLN d°| !ç ₧ * invalidComponentID -3000 í d ONLN d| ¿çM )ç!Component reference is not valid. í d ONLN d4¿ ║ █ (╒ 6QuickTime 1.6 Bug Fixes ┘ 4┘∙ í d ONLN dL╚ ╘═ *YQuickTime 1.6 fixes all known bugs in QuickTime 1.5. Many of these bugs are listed below. í d ONLN dªα ∞ f *Movie Toolbox í d ONLN d┤° ! ° + +Ñ╩The Movie Toolbox interesting time calls í d ONLN d▀° °┌ )╫,have been substantially improved. The values í d ONLN d * (, H/returned are much more consistant and accurate. í d ONLN d< !( ( (D ?Ñ╩ í d ONLN d> (( d ) GetMoviePict í d ONLN dJ d( ± )< has two major improvements: í d ONLN dg) 34 o (P Q GetMoviePict í d ONLN ds( o4] )<2 no longer fails on certain Compact Video movies. í d ONLN dª5 3@ o (\ Q GetMoviePict í d ONLN d▓4 o@ÿ )<> now reports out of memory errors rather than returning empty í d ONLN d≡4ÿ@┌ (\╢pictures when í d ONLN d■@ 3L | (h Qmemory is low. í d ONLN dX !d ( (Ç ?Ñ╩ í d ONLN dY (d ç )UpdateMovieResource í d ONLN d"X çd/ )_& has been fixed for single fork files. í d ONLN dIp !|» (ÿ ?XÑ╩Editing movie's with alternate tracks no longer causes duplicate tracks to be created. ▀ 4▀∙
(≥ 6QuickTime 1.6 Tech Note (≥╓15 )
of 18 ñ ╫# # ╫
d , Times
. +6,Macintosh Technical Notes . 4 .∙ í d ONLN d ! (_ + BÑ╩Movie Uncover Procedures have been significantly improved. If a í d ONLN d B _ (┌ ( D}movie with tracks that are í d ONLN d ] ( * 4? ( P H7semi-transparent has a Movie Uncover procedure set (by ,
Courier í d ONLN d ö )? 4Ö ( P]SetMovieCoverProcs í d ONLN d ª (Ö 4╡ )Z), the í d ONLN d ¡ (╡ 4┌ ) uncover í d ONLN d ╡ 4 * @ ß ( \ H$procedure is now called before each í d ONLN d ┘ 4 ß @┌ )╖2frame to fill/erase the background. Previously the í d ONLN d @ * L ┐ ( h H Movie Toolbox performed the í d ONLN d( @ ┐ L┌ )ò:erase, which limited a cover procedure aware application's í d ONLN dc L * X P ( t Hoptions. í d ONLN dl d ! p ° ( î ?*Ñ╩The dialog sequence that appears when a í d ONLN dû d ° p┌ )╫,movie data file is lost has been reworked to í d ONLN d├ p * | ( ÿ H6eliminate the "This is not a valid movie file" dialog. í d ONLN d· ê ! öí ( ░ ?HÑ╩Fixed problem with deactivating and reactivating Compact Video movies í d ONLN dB êí ö┌ ( ░┐ that caused í d ONLN dN ö * á ╙ ( ╝ H"╥shimmering╙ effects in the image. í d ONLN dq ¼ ! ╕ ( ( ╘ ?Ñ╩ í d ONLN ds ¡ ( ╕ é )GetMoviePosterPict í d ONLN dà ¼ é ╕, )Z# now properly handles tracks which í d ONLN d¿ ¼, ╕┌ )¬%are only in the poster and not in the í d ONLN d╬ ╕ * ─ I ( α Hmovie. í d ONLN d╒ ╨ ! ▄ ▀ ( ° ?'Ñ╩Movies played in loop mode using the í d ONLN dⁿ ╨ ▀ ▄┌ )╛2Movie Controller no longer briefly pause when they í d ONLN d/ ▄ * Φ) ( H5jump from the end back to the beginning of the movie. í d ONLN de ⌠ r ( 6Movie Controller í d ONLN dv !â + JÑ╩The Movie Controller performs much smarter drawing, so it takes up less í d ONLN d└ â┌ (4ítime during movie í d ONLN d╥ *$ W (@ H playback. í d ONLN d▄0 !<╢ (X ?VÑ╩The Movie Controller no longer leaves the port clip changed after drawing the badge. í d ONLN d3H T å (p 6Movie Import/Export í d ONLN dG` !l╣ + SÑ╩The Import AIFF Sound File to Movie component now always imports the entire file. í d ONLN d¢x !ä ô *Ñ╩The PICT and PICS í d ONLN d»x ôä┌ )r=import components no longer scale down images larger than the í d ONLN dφä *É K (¼ Hscreen. í d ONLN d⌡£ ¿ ü (─ 6Text Media Handler í d ONLN d┤ !└ ù + Ñ╩When multi-line text is í d ONLN d"┤ ù└┌ )vCgrown, lines after line 1 were not displayed. The bug did not occur í d ONLN df└ *╠ Σ (Φ H'when grown exactly 2x. It is now fixed. í d ONLN dÄ╪ !Σ ç ( ?Ñ╩Empty text samples í d ONLN dú╪ çΣ┌ )fCsometimes caused the Text Media Handler to lose track of subsequent í d ONLN dτΣ *≡ ¥ ( Htext size. It is now fixed. í d ONLN dⁿ ! ( ($ ?Ñ╩ í d ONLN d² ( P )FindText í d ONLN dⁿ P w )( did not í d ONLN dⁿ w┌ )'Kdo "case insensitive" searches properly. Furthermore it tried to dispose of í d ONLN db * (0 H4the text string that was passed in. It is now fixed. í d ONLN dù !, ( (H ?Ñ╩ í d ONLN dÖ! (, P )FindText í d ONLN dí P,å )(@ "wrap around" search did not always work properly. It now does. í d ONLN dΓ8 !D] (` ?CÑ╩Hilite text samples did not always display properly. They now do. í d ONLN d&P !\ ╞ *"Ñ╩If the track contained multiple í d ONLN dHP ╞\┌ )Ñ5text descriptions, performance was sometimes severely í d ONLN d~\ *h í (ä Hdegraded -- not anymore. í d ONLN dùt !Ç( (£ ?8Ñ╩Text clipping and scrolling is now much more reliable. í d ONLN d╨î ÿ ░ (┤ 6Image Compression Manager í d ONLN dΩñ !░ % + Ñ í d ONLN d∞ñ *░ ? ) The í d ONLN d≡Ñ ?░ v ) AlignWindow í d ONLN d√ñ v░h )77 call has been fixed to respect vertical repositioning. ▀ 4▀∙
(≥ 616 )
of 18 (≥æQuickTime 1.6 Tech Note ÷ ╫# # ╫
d , Times
. +6,Developer Technical Support ( ,╠
April 1993 . 4 .∙ í d ONLN d ( 4 i ( P 6Compact Video í d ONLN d @ ! L % + Ñ í d ONLN d @ * L é ) In some cases, the í d ONLN d # @ é L┌ )XFCompact Video compressor allowed the data rate to exceed the limit set í d ONLN d j L * X l ( t Hby the calling í d ONLN d y L l X┌ )BIapplication, causing playback problems from CD. QuickTime 1.6 fixes this í d ONLN d ├ X * d ? ( Ç Hbug. í d ONLN d ╚ p ! | % ( ÿ ?Ñ í d ONLN d ╩ p * | ) ,Decompressing gray scale Compact Video data í d ONLN d ÷ p |┌ )φ'to an 8-bit color destination no longer í d ONLN d | * ê P ( ñ Hcrashes. í d ONLN d' ö á ù ( ╝ 6Photo CD Decompressor í d ONLN d= ¼ ! ╕ % + Ñ í d ONLN d? ¼ * ╕' ) 4More accurate colors in decompression are displayed. í d ONLN dt ─ ╨ æ ( ∞ 6Standard Compression í d ONLN dë ▄ ! Φ % + Ñ í d ONLN dï ▄ * Φ 5 ) If ,
Courier í d ONLN dÄ ▌ 5 Φ Ö ) scAllowZeroFrameRate í d ONLN dó ▄ Ö Φ( )d" is true, default to 0 frame rate. í d ONLN d┼ ⌠ ! % ( ?Ñ í d ONLN d╟ ⌠ * £ ) JThe key frame rate now updates correctly when changed from hook procedure. í d ONLN d ! % (4 ?Ñ í d ONLN d *K ) >Rate-constrain item checked if non-zero default value present. í d ONLN dS$ 0 w (L 6Sequence Grabber í d ONLN dd< !H % + Ñ í d ONLN df< *H= ) 8Sound wouldn╒t get restarted or turned off correctly if í d ONLN d₧<=H┌ (d[ the record bit wasn╒t set in its í d ONLN d┐H *T ╣ (p H channel usage. It is now fixed. í d ONLN d▀` !l % (ê ?Ñ í d ONLN dß` *la ) DVideo panel does not bus error if the digitizer doesn't support hue. í d ONLN d&x ä å (á 6Component Manager í d ONLN d8É !£ } + Ñ The Component í d ONLN dHÉ }£┌ )\BManager no longer changes the current resource file when loading a í d ONLN dï£ *¿ d (─ H
Component. í d ONLN dû┤ !└ * (▄ ?Ñ í d ONLN dÿ┤ *└┌ ) QThe Component Manager now tracks files using File ID's when possible, rather than í d ONLN dΩ┴ *╠ H * FSSpec í d ONLN d≡└ H╠ R ) 's. í d ONLN d⌠╪ !Σ % ( ?Ñ í d ONLN d÷╪ *Σ µ ) &Fixed obscure boot problem that would í d ONLN d ╪ µΣ┌ )╝/hang the machine when a component was called to í d ONLN dLΣ *≡Z ( H>register and the system heap was extremely low on free memory. í d ONLN dïⁿ ! % ($ ?Ñ í d ONLN dìⁿ * o ) It is now OK í d ONLN dÜⁿ o √ )Eto pass an empty handle to í d ONLN d╡² √K )îGetComponentInfo í d ONLN d┼ⁿK┌ )P . This is helpful, since it can í d ONLN dσ * c (0 H return them. í d ONLN d≥* 6 y (R 6Further Reference: U 4U∙ í d ONLN d7 *C . +Ñ í d ONLN d7 <C Ä )Inside Macintosh í d ONLN d7 ÄC ╚ )R , QuickTime í d ONLN d#C *O . (k HÑ í d ONLN d%C <O Ä )Inside Macintosh í d ONLN d5C ÄO )R, QuickTime Components ▀ 4▀∙
